XmlReadMode 列挙型

定義

XML データとリレーショナル スキーマを DataSet に読み込む方法を指定します。Specifies how to read XML data and a relational schema into a DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
継承
XmlReadMode

フィールド

Auto 0

既定の読み取りモード。The default read mode.

DiffGram 4

DiffGram を読み込んで、変更を DiffGram から DataSet に適用します。Reads a DiffGram, applying changes from the DiffGram to the DataSet. セマンティクスは Merge(DataSet) 操作の場合と同じです。The semantics are identical to those of a Merge(DataSet) operation. Merge(DataSet) 操作の場合と同様に、RowState 値が保存されます。As with the Merge(DataSet) operation, RowState values are preserved. DiffGram による ReadXml(XmlReader) への入力は、WriteXml(Stream) からの出力を DiffGram として使用する方法によってだけ取得する必要があります。Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

ターゲットの DataSet は、DiffGram として WriteXml が呼び出される DataSet と同じスキーマを持つ必要があります。The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. それ以外の場合、DiffGram のマージ操作が失敗し、例外がスローされます。Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment 5

SQL Server のインスタンスに対して、XML フラグメント (FOR XML クエリを実行して生成されたものなど) を読み込みます。Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. XmlReadModeFragment に設定されている場合は、既定の名前空間がインライン スキーマとして読み込まれます。When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema 2

インライン スキーマを無視し、データを既存の DataSet スキーマに読み取ります。Ignores any inline schema and reads data into the existing DataSet schema. 既存のスキーマと一致しないデータがある場合、そのデータ (DataSet 用に定義された、異なる名前空間からのデータを含む) は破棄されます。If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). データが DiffGram の場合、IgnoreSchemaDiffGram と同じ機能を果たします。If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema 3

インライン スキーマを無視し、データからスキーマを推論し、データを読み込みます。Ignores any inline schema, infers schema from the data and loads the data. DataSet が既にスキーマを格納している場合は、新しいテーブルを追加するか、既存のテーブルに新しい列を追加して、現在のスキーマを拡張します。If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. 推論されたテーブルが既に存在するが名前空間が異なる場合、または推論された列が既存の列と矛盾する場合は例外がスローされます。An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

InferTypedSchema 6

インライン スキーマを無視し、厳密に型指定されたスキーマをデータから推論し、データを読み込みます。Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. データから型を推測できない場合は、文字列データとして解釈されます。If the type cannot be inferred from the data, it is interpreted as string data. DataSet が既にスキーマを格納している場合は、新しいテーブルを追加するか、既存のテーブルに新しい列を追加して、現在のスキーマを拡張します。If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. 推論されたテーブルが既に存在するが名前空間が異なる場合、または推論された列が既存の列と矛盾する場合は例外がスローされます。An exception is thrown if the inferred table already exists but with a different namespace, or if any of the inferred columns conflict with existing columns.

ReadSchema 1

インライン スキーマを読み込み、データを読み込みます。Reads any inline schema and loads the data. DataSet が既にスキーマを格納している場合は、新しいテーブルをスキーマに追加できますが、インライン スキーマ内のテーブルが既に DataSet 内に存在する場合は例外がスローされます。If the DataSet already contains schema, new tables may be added to the schema, but an exception is thrown if any tables in the inline schema already exist in the DataSet.

注釈

メソッドのパラメーターを設定するときに、この列挙体のメンバーを使用し ReadMode DataSet.ReadXml ます。Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

注意

Autoモードは XmlReadMode 、明示的なオプションに設定した場合よりも低速になることがあります。Auto mode may be slower than setting XmlReadMode to an explicit option.

Autoでは、次のアクションに最適なが実行されます。Auto performs the most appropriate of these actions:

  • データが DiffGram の場合は、XML 読み取りモードをに設定し DiffGram ます。If the data is a DiffGram, sets the XML read mode to DiffGram.

  • Dataset に既にスキーマがある場合、またはドキュメントにインラインスキーマが含まれている場合は、によって XML 読み取りモードがに設定され ReadSchema ます。If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • データセットにスキーマが含まれておらず、ドキュメントにインラインスキーマが含まれていない場合は、によって XML 読み取りモードがに設定され InferSchema ます。If the dataset does not already have a schema and the document does not contain an in-line schema, sets the XML read mode to InferSchema.

適用対象