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 的 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 中,則會擲回例外狀況。

備註

設定 方法的參數 DataSet.ReadXmlReadMode ,請使用這個列舉的成員。

注意

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

Auto 會執行最適當的這些動作:

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

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

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

適用於