XmlReadMode 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

XmlReadMode 列挙体

XML データとリレーショナルスキーマを DataSet に読み込む方法を指定します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Enumeration XmlReadMode

Visual Basic (使用法)

Dim instance As XmlReadMode

public enum XmlReadMode

C++

public enum class XmlReadMode

public enum XmlReadMode

JScript

public enum XmlReadMode

メンバ

	メンバ名	説明
	Auto	既定。これらのアクションのうち最適なアクションを実行します。データが DiffGram の場合は、XmlReadMode を DiffGram に設定します。またはデータセットが既にスキーマを持っているか、ドキュメントにインラインスキーマが格納されている場合は、XmlReadMode を ReadSchema に設定します。またはデータセットがスキーマを持っておらず、ドキュメントにインラインスキーマが格納されていない場合は、XmlReadMode を InferSchema に設定します。
	DiffGram	DiffGram を読み込んで、変更を DiffGram から DataSet に適用します。セマンティクスは Merge 操作の場合と同じです。Merge 操作の場合と同様に、RowState 値が保存されます。DiffGram による ReadXml への入力は、WriteXml からの出力を DiffGram として使用する方法によってだけ取得する必要があります。ターゲット DataSet は、WriteXml を DiffGram として呼び出した DataSet と同じスキーマを持っている必要があります。それ以外の場合は DiffGram マージ操作が失敗し、例外がスローされます。
	Fragment	SQL Server のインスタンスに対して、XML フラグメント (FOR XML クエリを実行して生成されたものなど) を読み込みます。XmlReadMode が Fragment に設定されている場合は、既定の名前空間がインラインスキーマとして読み込まれます。
	IgnoreSchema	インラインスキーマを無視し、既存の DataSet スキーマにデータを読み込みます。既存のスキーマと一致しないデータがある場合、そのデータ (DataSet 用に定義された、異なる名前空間からのデータを含む) は破棄されます。データが DiffGram の場合、IgnoreSchema は DiffGram と同じ機能を果たします。
	InferSchema	インラインスキーマを無視し、データからスキーマを推論し、データを読み込みます。DataSet が既にスキーマを格納している場合は、新しいテーブルを追加するか、既存のテーブルに新しい列を追加して、現在のスキーマを拡張します。推論されたテーブルが既に存在するが名前空間が異なる場合、または推論された列が既存の列と矛盾する場合は例外がスローされます。
	InferTypedSchema	インラインスキーマを無視し、厳密に型指定されたスキーマをデータから推論し、データを読み込みます。データから型を推測できない場合は、文字列データとして解釈されます。DataSet が既にスキーマを格納している場合は、新しいテーブルを追加するか、既存のテーブルに新しい列を追加して、現在のスキーマを拡張します。推論されたテーブルが既に存在するが名前空間が異なる場合、または推論された列が既存の列と矛盾する場合は例外がスローされます。
	ReadSchema	インラインスキーマを読み込み、データを読み込みます。DataSet が既にスキーマを格納している場合は、新しいテーブルをスキーマに追加できますが、インラインスキーマ内のテーブルが既に DataSet 内に存在する場合は例外がスローされます。

解説

この列挙体のメンバは、ReadXml メソッドの ReadMode パラメータを設定するときに使用します。

メモ
Auto モードを使用すると、XmlReadMode を明示的なオプションに設定する場合に比べて低速になることがあります。