XML 架构定义工具 (Xsd.exe)

.NET Framework 工具

XML 架构定义工具 (Xsd.exe)

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

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

参数	说明
file.extension	指定要转换的输入文件。必须将扩展名指定为下列之一：.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，依此类推。仅当给定类型使用 XMLRoot 自定义属性指定命名空间时，Xsd.exe 才生成多个架构。

参数

说明

file.extension

指定要转换的输入文件。必须将扩展名指定为下列之一：.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，依此类推。仅当给定类型使用 XMLRoot 自定义属性指定命名空间时，Xsd.exe 才生成多个架构。

选项	说明
/h[elp]	显示该工具的命令语法和选项。
/o[utputdir]:directory	指定输出文件的目录。此参数只能出现一次。默认为当前目录。
/?	显示该工具的命令语法和选项。
/P[arameters]: file.xml	从指定的 .xml 文件读取各种操作模式的选项。缩写形式为“/p:”。有关更多信息，请参见下面的“备注”部分。

必须为 xsd 文件仅指定下列选项中的一个。

选项	说明
/c[lasses]	生成与指定架构相对应的类。若要将 XML 数据读入对象，请使用 System.Xml.Serialization.XmlSerializer.Deserializer [ http://msdn2.microsoft.com/zh-cn/library/system.xml.serialization.xmlserializer.deserialize.aspx ] 方法。
/d[ataset]	生成一个从 DataSet [ http://msdn2.microsoft.com/zh-cn/library/system.data.dataset.aspx ] 派生的类，该类与指定的架构相对应。若要将 XML 数据读入派生类，请使用 System.Data.DataSet.ReadXml [ http://msdn2.microsoft.com/zh-cn/library/system.data.dataset.readxml.aspx ] 方法。

还可以为 .xsd 文件指定下列任何选项。

选项	说明
/e[lement]:element	指定架构中要为其生成代码的元素。默认情况下，键入所有元素。可以多次指定该参数。
/enableDataBinding	在所有生成的类型上实现 INotifyPropertyChanged [ http://msdn2.microsoft.com/zh-cn/library/system.componentmodel.inotifypropertychanged.aspx ] 接口以启用数据绑定。缩写形式为“/edb”。
/f[ields]	生成字段，而不是生成属性。默认情况下生成属性。
/l[anguage]:language	指定要使用的编程语言。从 CS（默认情况下为 C#）、VB (Visual Basic)、JS (JScript) 或 VJS (Visual J#) 中进行选择。还可以为实现 System.CodeDom.Compiler.CodeDomProvider [ http://msdn2.microsoft.com/zh-cn/library/system.codedom.compiler.codedomprovider.aspx ] 的类指定完全限定名。
/n[amespace]:namespace	为生成的类型指定运行库命名空间。默认命名空间为 Schemas。
/nologo	取消显示版权标志。
/order	在所有粒子成员上生成显式顺序标识符。
/o[ut]: directoryName	指定要放置文件的输出目录。默认为当前目录。
/u[ri]:uri	为架构中要为其生成代码的元素指定 URI。该 URI（如果存在）应用于使用 /element 选项指定的所有元素。