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 では、World Wide Web Consortium (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

一方、アセンブリ内の 1 つの型のスキーマを生成する場合は、次の 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> 要素を使用します。 次の例では、コード ファイルを生成します。 生成されたファイルのプログラミング言語と名前空間を設定できる 2 つの属性も表示されることに注意してください。

<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 コードを作成することを指定します。 生成された DataSet 構造体は、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> 要素で使用できる属性を示します。

例示

次のコマンドは、 myFile.xdr から XML スキーマを生成し、現在のディレクトリに保存します。

xsd myFile.xdr

次のコマンドは、 myFile.xml から 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
• ツール
• 開発者コマンドライン シェル
• LINQ to DataSet の概要
• 型指定されたデータセットのクエリ
• LINQ (Language-Integrated クエリ) (C#)
• LINQ (Language-Integrated クエリ) (Visual Basic)