XmlReadMode 列挙型

定義

名前空間:

System.Data

アセンブリ:

System.Data.Common.dll

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

public enum class XmlReadMode

public enum XmlReadMode

type XmlReadMode = 

Public Enum XmlReadMode

継承

Object

ValueType

Enum

XmlReadMode

フィールド

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

注釈

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

注意

Auto モードは、明示的なオプションに設定 XmlReadMode するよりも遅い場合があります。

Auto は、次のアクションのうち最も適切なアクションを実行します。

• データが DiffGram の場合、XML 読み取りモードを に DiffGram設定します。

• データセットに既にスキーマがある場合、またはドキュメントにインライン スキーマが含まれている場合は、XML 読み取りモードを に ReadSchema設定します。

• データセットにスキーマがまだなく、ドキュメントにインライン スキーマが含まれていない場合は、XML 読み取りモードを に InferSchema設定します。