XML シリアライザ ジェネレータ ツール (Sgen.exe)

XML シリアライザ ジェネレータは、指定された型のオブジェクトをシリアル化または逆シリアル化するとき、XmlSerializer の起動パフォーマンスを向上させるために、指定されたアセンブリの型に対して XML シリアル化アセンブリを作成します。

sgen [options]

パラメータ

オプション	説明
/a[ssembly]:filename	アセンブリまたは filename によって指定される実行可能ファイルに含まれるすべての型に対して、シリアル化コードを生成します。1 つのファイル名のみを指定できます。この引数を繰り返した場合は、最後のファイル名が使用されます。
/c[ompiler]: options	オプションを C# コンパイラに渡すように指定します。csc.exe のすべてのオプションがサポートされ、コンパイラに渡されます。このオプションを使用して、アセンブリに署名してキー ファイルを指定するように指定できます。
/d[ebug]	デバッガで使用できるイメージを生成します。
/f[orce]	同じ名前の既存のアセンブリに上書きします。既定値は false です。
/help or /?	このツールのコマンド構文とオプションを表示します。
/k[eep]	生成されたソース ファイルとその他の一時ファイルをシリアル化アセンブリにコンパイルした後、元のファイルを削除しません。このオプションは、ツールが特定の型に対してシリアル化コードを生成するかどうかを決定するために使用できます。
/n[ologo]	Microsoft の著作権情報を表示しません。
/o[ut]:path	生成されたアセンブリの保存先のディレクトリを指定します。 メモ : 生成されたアセンブリの名前は、入力アセンブリの名前と "xmlSerializers.dll" で構成されます。
/p[roxytypes]	XML Web サービス プロキシ型に対してのみシリアル化コードを生成します。
/r[eference]:assemblyfiles	XML シリアル化で必要な型によって参照されるアセンブリを指定します。コンマで区切られた複数のアセンブリ ファイルを受け入れます。
/s[ilent]	成功メッセージを表示しません。
/t[ype]:type	指定された型に対してのみ、シリアル化コードを生成します。
/v[erbose]	デバッグに関する詳細出力を表示します。XmlSerializer でシリアル化できない対象アセンブリの型を一覧表示します。
/?	このツールのコマンド構文とオプションを表示します。

解説

XML シリアライザ ジェネレータを使用しないとき、XmlSerializer はアプリケーションを実行するたびに、各型に対してシリアル化コードとシリアル化アセンブリを生成します。XML シリアル化起動のパフォーマンスを向上させるために、Sgen.exe ツールを使用して前もってこれらのアセンブリを生成します。これらのアセンブリは、アプリケーションで配置できます。

XML シリアライザ ジェネレータは、サーバーとの通信に XML Web サービス プロキシを使用するクライアントのパフォーマンスも向上させますが、これは型が初めて読み込まれるとき、シリアル化プロセスによってパフォーマンスが低下しないためです。

これらの生成されたアセンブリは、Web サービスのサーバー側では使用できません。このツールは、Web サービス クライアントと手動シリアル化シナリオに対してのみ使用できます。

シリアル化する型を含むアセンブリの名前が MyType.dll の場合、関連するシリアル化アセンブリの名前は MyType.XmlSerializers.dll となります。

例

次のコマンドは、Data.dll という名前のアセンブリに含まれるすべての型をシリアル化するために、Data.XmlSerializers.dll という名前のアセンブリを作成します。

sgen Data.dll 

Data.XmlSerializers.dll アセンブリは、Data.dll の型をシリアル化および逆シリアル化する必要のあるコードから参照できます。

参照

関連項目

.NET Framework ツール
SDK のコマンド プロンプト

概念

XML Web サービスの概要