次の方法で共有


XmlReadMode 列挙型

定義

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

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
継承
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 クエリを実行して生成されたものなど) を読み込みます。 XmlReadModeFragment に設定されている場合は、既定の名前空間がインライン スキーマとして読み込まれます。

IgnoreSchema 2

インライン スキーマを無視し、データを既存の DataSet スキーマに読み取ります。 既存のスキーマと一致しないデータがある場合、そのデータ (DataSet 用に定義された、異なる名前空間からのデータを含む) は破棄されます。 データが DiffGram の場合、IgnoreSchemaDiffGram と同じ機能を果たします。

InferSchema 3

インライン スキーマを無視し、データからスキーマを推論し、データを読み込みます。 DataSet が既にスキーマを格納している場合は、新しいテーブルを追加するか、既存のテーブルに新しい列を追加して、現在のスキーマを拡張します。 推論されたテーブルが既に存在するが名前空間が異なる場合、または推論された列が既存の列と矛盾する場合は例外がスローされます。

InferTypedSchema 6

インライン スキーマを無視し、厳密に型指定されたスキーマをデータから推論し、データを読み込みます。 データから型を推測できない場合は、文字列データとして解釈されます。 DataSet が既にスキーマを格納している場合は、新しいテーブルを追加するか、既存のテーブルに新しい列を追加して、現在のスキーマを拡張します。 推論されたテーブルが既に存在するが名前空間が異なる場合、または推論された列が既存の列と矛盾する場合は例外がスローされます。

ReadSchema 1

インライン スキーマを読み込み、データを読み込みます。 DataSet が既にスキーマを格納している場合は、新しいテーブルをスキーマに追加できますが、インライン スキーマ内のテーブルが既に DataSet 内に存在する場合は例外がスローされます。

注釈

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

注意

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

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

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

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

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

適用対象