XmlReadMode Wyliczenie

Definicja

Określa sposób odczytywania danych XML i schematu relacyjnego w 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
Dziedziczenie
XmlReadMode

Pola

Auto 0

Domyślny tryb odczytu.The default read mode.

DiffGram 4

Odczytuje element DiffGram, stosując zmiany z elementu DiffGram do DataSet.Reads a DiffGram, applying changes from the DiffGram to the DataSet. Semantyka jest taka sama jak w przypadku operacji Merge(DataSet).The semantics are identical to those of a Merge(DataSet) operation. Podobnie jak w przypadku operacji Merge(DataSet), RowState wartości są zachowywane.As with the Merge(DataSet) operation, RowState values are preserved. Dane wejściowe do ReadXml(XmlReader) za pomocą DiffGrams powinny być uzyskiwane tylko przy użyciu danych wyjściowych z WriteXml(Stream) jako DiffGram.Input to ReadXml(XmlReader) with DiffGrams should only be obtained using the output from WriteXml(Stream) as a DiffGram.

Docelowa DataSet musi mieć ten sam schemat co DataSet, w którym WriteXml jest wywoływana wartość DiffGram.The target DataSet must have the same schema as the DataSet on which WriteXml as DiffGram is called. W przeciwnym razie operacja scalania w formacie DiffGram kończy się niepowodzeniem i zostanie zgłoszony wyjątek.Otherwise the DiffGram merge operation fails and an exception is thrown.

Fragment 5

Odczytuje fragmenty XML, takie jak te wygenerowane przez wykonywanie dla zapytań XML, w odniesieniu do wystąpienia SQL Server.Reads XML fragments, such as those generated by executing FOR XML queries, against an instance of SQL Server. Gdy XmlReadMode jest ustawiona na Fragment, domyślny obszar nazw jest odczytywany jako schemat wbudowany.When XmlReadMode is set to Fragment, the default namespace is read as the inline schema.

IgnoreSchema 2

Ignoruje wszystkie wbudowane schemat i odczytuje dane w istniejącym schemacie DataSet.Ignores any inline schema and reads data into the existing DataSet schema. Jeśli dowolne dane nie są zgodne z istniejącym schematem, zostanie on odrzucony (w tym dane z różnych przestrzeni nazw zdefiniowanych dla DataSet).If any data does not match the existing schema, it is discarded (including data from differing namespaces defined for the DataSet). Jeśli dane są w formacie DiffGram, IgnoreSchema ma te same funkcje co DiffGram.If the data is a DiffGram, IgnoreSchema has the same functionality as DiffGram.

InferSchema 3

Ignoruje wszystkie wbudowane schematy, wnioskuje dane i ładuje dane.Ignores any inline schema, infers schema from the data and loads the data. Jeśli DataSet zawiera już schemat, bieżący schemat zostanie rozszerzony przez dodanie nowych tabel lub dodanie kolumn do istniejących tabel.If the DataSet already contains a schema, the current schema is extended by adding new tables or adding columns to existing tables. Wyjątek jest zgłaszany, jeśli wywnioskowana tabela już istnieje, ale z inną przestrzenią nazw lub Jeśli którakolwiek z wywnioskowanych kolumn koliduje z istniejącymi kolumnami.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

Ignoruje wszystkie wbudowane schematy, wnioskuje silnie Typ schemat z danych i ładuje dane.Ignores any inline schema, infers a strongly typed schema from the data, and loads the data. Jeśli typ nie może zostać wywnioskowany na podstawie danych, jest interpretowany jako dane ciągu.If the type cannot be inferred from the data, it is interpreted as string data. Jeśli DataSet zawiera już schemat, bieżący schemat zostanie rozszerzony, dodając nowe tabele lub dodając kolumny do istniejących tabel.If the DataSet already contains a schema, the current schema is extended, either by adding new tables or by adding columns to existing tables. Wyjątek jest zgłaszany, jeśli wywnioskowana tabela już istnieje, ale z inną przestrzenią nazw lub Jeśli którakolwiek z wywnioskowanych kolumn koliduje z istniejącymi kolumnami.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

Odczytuje wszystkie wbudowane schematy i ładuje dane.Reads any inline schema and loads the data. Jeśli DataSet już zawiera schemat, nowe tabele mogą zostać dodane do schematu, ale wyjątek jest zgłaszany, jeśli wszystkie tabele w schemacie wbudowanym już istnieją w 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.

Uwagi

Użyj elementów członkowskich tego wyliczenia podczas ustawiania parametru ReadMode metody DataSet.ReadXml.Use the members of this enumeration when setting the ReadMode parameter of the DataSet.ReadXml method.

Uwaga

Tryb Auto może być wolniejszy niż ustawienie opcji XmlReadMode na jawną.Auto mode may be slower than setting XmlReadMode to an explicit option.

Auto wykonuje najbardziej odpowiednie działania:Auto performs the most appropriate of these actions:

  • Jeśli dane są w formacie DiffGram, ustawia tryb odczytu XML na DiffGram.If the data is a DiffGram, sets the XML read mode to DiffGram.

  • Jeśli zestaw danych ma już schemat lub jeśli dokument zawiera schemat w wierszu, ustawia tryb odczytu XML na ReadSchema.If the dataset already has a schema, or if the document contains an in-line schema, sets the XML read mode to ReadSchema.

  • Jeśli zestaw danych nie ma jeszcze schematu i dokument nie zawiera schematu w wierszu, ustawia tryb odczytu XML na 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.

Dotyczy