Інструмент визначення схеми XML (), Microsoft Docs

Інструмент визначення схеми XML (Xsd.exe) створює схему XML або класи CLR із файлів XDR, XML і XSD або з класів у збиранні середовища виконання.

Вказує вхідний файл, який потрібно перетворити. Слід зазначити одне з таких розширень: XDR, XML, XSD, DLL або EXE.

Якщо вказати файл XDR (розширення XDR), Xsd.exe перетворює схему XDR на схему XSD. Ім'я вихідного файлу подібне до імені схеми XDR, але має розширення XSD.

Якщо вказати XML-файл (розширення XML), Xsd.exe визначає схему даних у файлі і створює схему XSD. Ім'я вихідного файлу подібне до імені XML-файлу, але має розширення XSD.

Якщо вказати файл схеми XML (розширення XSD), Xsd.exe створює вихідний код для об'єктів середовища виконання, які відповідають схемі XML.

Якщо вказати файл збирання середовища виконання (розширення EXE або DLL), Xsd.exe створює схеми для одного або декількох типів у цій збірці. Щоб вказати типи, для яких потрібно створити схеми, можна використовувати параметр /type. Вихідним схемам присвоюються імена schema0.xsd, schema1.xsd і т. д. Xsd.exe створює кілька схем, тільки якщо зазначені типи задають простір імен з використанням атрибута XMLRoot, що настроюється.

Загальні параметри

Відображає синтаксис команд та параметрів програми.

Вказує каталог вихідних файлів. Цей аргумент відображається лише один раз. Значенням за промовчанням є поточний каталог.

Відображає синтаксис команд та параметрів програми.

Зчитує параметри різних режимів операцій із зазначеного XML-файлу. Коротка форма "/p:". Додаткові відомості див. у розділі "Примітки".

Параметри файлу XSD

Для файлів XSD слід вказати лише один із наступнихпараметрів.

Створює класи, які відповідають зазначеній схемі. Щоб рахувати дані XML в об'єкті, використовуйте метод System.Xml.Serialization.XmlSerializer.Deserializer.

Створює класи, які є похідними класу DataSet та відповідають зазначеній схемі. Щоб рахувати дані XML у похідний клас, використовуйте метод System.Data.DataSet.ReadXml.

Для файлів XSD також можна вказати будь-який з наведених нижче параметрів.

Визначає елемент у схемі, котрій створюється код. За промовчанням всі елементи мають тип. Цей аргумент можна поставити кілька разів.

Реалізує інтерфейс INotifyPropertyChanged для всіх створених типів для забезпечення прив'язування даних. Коротка форма – "/edb".

(Коротка форма: /eld.) Вказує, що створений набір даних можна запросити за допомогою LINQ to DataSet. Цей параметр використовується лише при вказанні /dataset. Щоб отримати додаткові відомості, див. Загальні відомості про LINQ to DataSet та Запит до типізованих об'єктів DataSet. Загальні відомості про використання LINQ див. у розділі LINQ.

Створює поля замість властивостей. За промовчанням створюються властивості.

Задає мову програмування, що використовується. Доступний вибір: CS (C#, за промовчанням), VB (Visual Basic), JS (JScript) або VJS (Visual J#). Також можна вказати повне ім'я класу, який реалізує CodeDomProvider

Визначає простір імен середовища виконання для створюваних типів. Простір стандартних імен — Schemas.

Створює явні ідентифікатори для всіх примітивних членів.

Вказує вихідний каталог, в якому слід розмістити файли. Значенням за промовчанням є поточний каталог.

Визначає універсальний код ресурсу (URI) для елементів схеми, котрий створюється код. Цей універсальний код ресурсуякщо є, застосовується до всіх елементів, заданих параметром /element.

Параметри файлів DLL та EXE

Вказує ім'я типу, для якого слід створити схему. Можна зазначити кілька аргументів типу. Якщо typename не вказує простір імен, Xsd.exe зіставляє всі типи у збірці із зазначеним типом. Якщо typename задає простір імен, зіставляється лише цей тип. Якщо typename закінчується знаком зірочки (*), інструмент зіставляє всі типи, які починаються з рядка, що передує знаку зірочки (*). Якщо параметр /type не заданий, Xsd.exe створює схеми всіх типів у збірці.

У наступній таблиці показано операції Xsd.exe.

XDR XSD Створює схему XML з файлу схеми XDR. XDR є більш раннім форматом схеми, що базується на XML.

XML XSD Створює схему XML з XML-файлу.

XSD DataSet Створює класи CLR DataSet з файлу схеми XSD. Створювані класи є об'єктна модель з широкими функціональними можливостями для звичайних даних XML.

XSD класи Створює класи середовища виконання з файлу схеми XSD. Створені класи можна використовувати разом з XmlSerializer для читання та запису коду XML, який відповідає схемі.

Класи в XSD Створює схему XML з типу або типів у файлі збирання середовища виконання. Створена схема визначає формат XML, який використовується System.Xml.Serialization.XmlSerializer.

Xsd.exe дозволяє керувати лише схемами XML, які відповідають мові визначення схеми XML (XSD), запропонованому консорціумом World Wide Web Consortium (W3C). Додаткові відомості про запропоноване визначення схеми XML або стандарту XML див. на веб-сайті http://w3.org.

Встановлення параметрів за допомогою файлу XML

За допомогою ключа /parameters можнавстановити один XML-файл, який містить різні параметри. Параметри, що задаються, залежать від способу використання інструменту XSD.exe. Варіанти включають створення схем, файлів коду або створення файлів коду, що містять функції DataSet. Наприклад, можна задати елемент як ім'я файлу (розширення EXE) або файлу бібліотеки типів (розширення DLL) під час створення схеми, але не при створенні файлу коду. У наступному прикладі XML показано, як використовувати елемент із зазначеним виконуваним файлом:

Якщо попередній XML міститься у файлі з ім'ям "GenerateSchemas.xml", використовуйте ключ /parameters, ввівши наступний текст у командному рядку та натиснувши клавішу ENTER:

З іншого боку, при створенні схеми для одного типу, знайденого у збиранні, можна використовувати наступний XML:

Але для використання попереднього коду в командному рядку слід також вказати ім'я збірки. У командному рядку введіть наступну команду (припустимо, ім'я файлу XML - GenerateSchemaFromType.xml):

xsd /p:GenerateSchemaFromType.xml ConsoleApplication1.exe

Для елемента слід вказати лише один із наведених нижче параметрів.

Визначає складання, з якого створюється схема.

Визначає тип, знайдений у збиранні, для якого створюється схема.

Задає файл XML, для якого створюється схема.

Визначає файл XDR для якого створюється схема.

Щоб створити файл коду, використовуйте . У цьому прикладі створюється файл коду. Зверніть увагу, що також відображаються два атрибути, за допомогою яких можна встановити мову програмування та простір імен створюваного файлу.

Параметри, які можна встановити для елемента , включають наступні.

Визначає елемент у файлі XSD, для якого створюється код.

Визначає тип,успадкований від класу SchemaImporterExtension.

Визначає файл схеми XML, для якої створюється код. За допомогою кількох елементів можна встановити кілька файлів схеми XML.

У наступній таблиці представлені атрибути, які можна використовувати з елементом .

Вказує простір імен створеного коду. Простір імен повинен відповідати стандартам CLR (наприклад, відсутність прогалин або зворотної косої межі).

Одне з таких значень: none, properties (створює властивості замість відкритих полів), order або enableDataBinding (див. ключі /order та/enableDataBinding у попередньому розділі параметрів файлу XSD).

Також передбачена можливість керування створенням коду DataSet з використанням елемента. Наступний XML-код вказує, що створений код використовує структури DataSet (наприклад, клас DataTable) для створення коду Visual Basic для зазначеного елемента. Створені структури DataSet підтримують запити на LINQ.

Параметри, які можна встановити для елемента , включають наступні.

У наведеній нижче таблиці представлені атрибути, які можна використовувати з елементом .

Вказує, що створений набір даних можна запросити за допомогою LINQ to DataSet. Значення за промовчанням є false.

Існують атрибути, які можна встановити для елемента верхнього рівня . Ці параметри можна використовувати з будь-яким із дочірніх елементів ( , або ). Наступний код XML створює код елемента з ім'ям "IDItems" у вихідному каталозі з ім'ям "MyOutputDirectory".

У наступній таблиці представлені атрибути, які можна використовувати з елементом .

Ім'я каталогу, у якому зберігається створена схема чи файл коду.

Вимикає банер. Вкажіть true або false.

Відображає синтаксис команд та параметрів програми. Вкажіть true або false.