XML 架构定义工具 （Xsd.exe）

XML 架构定义（Xsd.exe）工具从 XDR、XML 和 XSD 文件或运行时程序集中的类生成 XML 架构或公共语言运行时类。

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 只允许操作遵循由万维网联合会 (W3C) 提议的 XML 架构定义 (XSD) 语言的 XML 架构。 有关 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 代码为名为“MyOutputDirectory”的输出目录中名为“IDItems”的元素生成代码。

<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

以下命令为程序集 myAssembly.dll 中的所有类型生成 XML 架构，并将其保存为 schema0.xsd 当前目录中。

xsd myAssembly.dll

另请参阅

• DataSet
• System.Xml.Serialization.XmlSerializer
• 工具
• 开发人员命令行 shell
• LINQ to DataSet 概述
• 查询类型化数据集
• LINQ （Language-Integrated 查询） （C#）
• LINQ （Language-Integrated 查询） （Visual Basic）