Средство определения схемы XML (Xsd.exe)

Средство определения схемы XML (Xsd.exe) создает классы XML-схемы или среды CLR из файлов XDR, XML и XSD или из классов в сборке среды выполнения.

Обычно средство определения схемы XML (Xsd.exe) можно найти в следующем пути:
C:\Program Files (x86)\Microsoft SDKs\Windows\{version}\bin\NETFX {version} Tools\

Синтаксис

Запустите средство из командной строки.

xsd file.xdr [-outputdir:directory][/parameters:file.xml]
xsd file.xml [-outputdir:directory] [/parameters:file.xml]
xsd file.xsd {/classes | /dataset} [/element:element]
             [/enableLinqDataSet] [/language:language]
                          [/namespace:namespace] [-outputdir:directory] [URI:uri]
                          [/parameters:file.xml]
xsd {file.dll | file.exe} [-outputdir:directory] [/type:typename [...]][/parameters:file.xml]

Аргумент

Общие параметры

Параметры XSD-файла

Необходимо указать только один из следующих параметров для XSD-файлов.

Можно также указать любой из следующих параметров для XSD-файлов.

Параметры ФАЙЛА DLL и EXE

Замечания

В следующей таблице показаны операции, которые выполняет Xsd.exe.

Xsd.exe только позволяет управлять xml-схемами, которые соответствуют языку определения схемы XML (XSD), предлагаемому консорциумом W3C. Дополнительные сведения о предложении определения схемы XML или стандарте XML см. в разделе https://w3.org.

Настройка параметров с помощью XML-файла

С помощью /parameters переключателя можно указать один XML-файл, который устанавливает разные параметры. Параметры, которые можно задать, зависят от того, как вы используете средство XSD.exe. Варианты включают создание схем, создание файлов кода или создание файлов кода, которые включают DataSet функции. Например, элемент можно задать <assembly> для имени исполняемого файла (.exe) или библиотеки типов (.dll) при создании схемы, но не при создании файла кода. В следующем XML-коде показано, как использовать элемент <generateSchemas> с указанным исполняемым файлом.

<!-- This is in a file named GenerateSchemas.xml. -->
<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
<generateSchemas>
   <assembly>ConsoleApplication1.exe</assembly>
</generateSchemas>
</xsd>

Если предыдущий XML-код содержится в файле с именем GenerateSchemas.xml, используйте /parameters переключатель, введя следующий код в командной строке и нажав клавишу ВВОД:

 xsd /p:GenerateSchemas.xml

С другой стороны, если вы создаете схему для одного типа, найденного в сборке, можно использовать следующий XML:

<!-- This is in a file named GenerateSchemaFromType.xml. -->
<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
<generateSchemas>
   <type>IDItems</type>
</generateSchemas>
</xsd>

Но для использования предыдущего кода необходимо также указать имя сборки в командной строке. Введите следующее в командной строке (предполагая, что XML-файл называется GenerateSchemaFromType.xml):

xsd /p:GenerateSchemaFromType.xml ConsoleApplication1.exe

Для элемента необходимо указать только один из следующих параметров <generateSchemas> .

Чтобы создать файл кода, используйте <generateClasses> элемент. В следующем примере создается файл кода. Обратите внимание, что также показаны два атрибута, которые позволяют задать язык программирования и пространство имен созданного файла.

<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
<generateClasses language='VB' namespace='Microsoft.Serialization.Examples'/>
</xsd>
<!-- You must supply an .xsd file when typing in the command line.-->
<!-- For example: xsd /p:genClasses mySchema.xsd -->

Параметры, которые можно задать для <generateClasses> элемента, включают следующие.

В следующей таблице показаны атрибуты, которые также можно использовать с элементом <generateClasses> .

Вы также можете управлять тем, как DataSet код создается с помощью <generateDataSet> элемента. Следующий XML-код указывает, что созданный код использует DataSet структуры (например DataTable , класс) для создания кода Visual Basic для указанного элемента. Созданные структуры набора данных поддерживают запросы LINQ.

<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>
    <generateDataSet language='VB' namespace='Microsoft.Serialization.Examples' enableLinqDataSet='true'>
    </generateDataSet>
</xsd>

Параметры, которые можно задать для <generateDataSet> элемента, включают следующие.

В следующей таблице показаны атрибуты, которые можно использовать с элементом <generateDataSet> .

Существуют атрибуты, которые можно задать на элементе верхнего уровня <xsd> . Эти параметры можно использовать с любым дочерним элементом (<generateSchemas><generateClasses>или<generateDataSet>). Следующий XML-код создает код для элемента с именем IDItems в выходном каталоге с именем MyOutputDirectory.

<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/' output='MyOutputDirectory'>
<generateClasses>
    <element>IDItems</element>
</generateClasses>
</xsd>

В следующей таблице показаны атрибуты, которые также можно использовать с элементом <xsd> .

Примеры

Следующая команда создает XML-схему из myFile.xdr текущего каталога и сохраняет ее в текущем каталоге.

xsd myFile.xdr

Следующая команда создает XML-схему из myFile.xml и сохраняет ее в указанный каталог.

xsd myFile.xml /outputdir:myOutputDir

Следующая команда создает набор данных, соответствующий указанной схеме на языке C# и сохраняет его как XSDSchemaFile.cs в текущем каталоге.

xsd /dataset /language:CS XSDSchemaFile.xsd

Следующая команда создает XML-схемы для всех типов в сборке myAssembly.dll и сохраняет их как schema0.xsd в текущем каталоге.

xsd myAssembly.dll

См. также

• DataSet
• System.Xml.Serialization.XmlSerializer
• Инструменты
• Оболочки командной строки для разработчиков
• Обзор набора данных LINQ to DataSet
• Запросы типизированных наборов данных
• LINQ (запросLanguage-Integrated) (C#)
• LINQ (запросLanguage-Integrated) (Visual Basic)