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 的 WriteXml(Stream) 輸入，您應該只使用來自 ReadXml(XmlReader) 且為 DiffGram 形式的輸出。 目標 DataSet 必須與 WriteXml 呼叫 DiffGram 所在 DataSet 具有相同的結構描述。 否則，DiffGram 合併作業會失敗並擲回例外狀況。
Fragment	5	讀取 XML 片段，例如針對 SQL Server 的執行個體執行 FOR XML 查詢時所產生的片段。 當 XmlReadMode 設定為 Fragment 時，系統會將預設命名空間讀取為內嵌結構描述。
IgnoreSchema	2	忽略任何內嵌結構描述，並將資料讀入現有的 DataSet 結構描述中。 如果沒有任何資料符合現有的結構描述，則會捨棄該資料 (包括為 DataSet 定義之不同命名空間的資料)。 如果資料是 DiffGram，則 IgnoreSchema 具有與 DiffGram 相同的功能。
InferSchema	3	忽略任何內嵌結構描述、從資料推斷結構描述，並載入資料。 如果 DataSet 已經含有結構描述，則會新增新的資料表或將資料行新增至現有資料表，以擴充目前的結構描述。 如果推斷的資料表已經存在，但是具有不同的命名空間，或者如果任何的推斷資料行與現有資料行衝突，則會擲回例外狀況。
InferTypedSchema	6	忽略任何內嵌結構描述，從資料推斷出強型別結構描述，並載入資料。 如果無法從資料推斷類型，就會將其解譯為字串資料。 如果 DataSet 已經含有結構描述，則會新增新的資料表或將資料行新增至現有資料表，以擴充目前的結構描述。 如果推斷的資料表已經存在，但是具有不同的命名空間，或者如果任何的推斷資料行與現有資料行衝突，則會擲回例外狀況。
ReadSchema	1	讀取任何內嵌結構描述，並載入資料。 如果 DataSet 已經含有結構描述，則可能會將新的資料表新增至結構描述，但如果內嵌結構描述中的任何資料表已經存在於 DataSet 中，則會擲回例外狀況。

備註

設定 方法的參數時ReadModeDataSet.ReadXml，請使用這個列舉的成員。

注意

Auto 模式可能會比設定 XmlReadMode 為明確選項慢。

Auto 執行最適當的這些動作：

• 如果資料是 DiffGram，請將 XML 讀取模式設定為 DiffGram。

• 如果資料集已經有架構，或檔案包含內嵌架構，請將 XML 讀取模式設定為 ReadSchema。

• 如果資料集還沒有架構，而且檔案未包含內嵌架構，請將 XML 讀取模式設定為 InferSchema。