XmlReadMode Wyliczenie

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.dll

Określa sposób odczytywania danych XML i schematu relacyjnego do DataSet.

public enum class XmlReadMode

public enum XmlReadMode

type XmlReadMode = 

Public Enum XmlReadMode

Dziedziczenie

Object

ValueType

Enum

XmlReadMode

Pola

Nazwa	Wartość	Opis
Auto	0	Domyślny tryb odczytu.
ReadSchema	1	Odczytuje dowolny schemat wbudowany i ładuje dane. DataSet Jeśli schemat zawiera już schemat, do schematu mogą zostać dodane nowe tabele, ale zostanie zgłoszony wyjątek, jeśli w schemacie wbudowanym istnieją już tabele w schemacie DataSet.
IgnoreSchema	2	Ignoruje dowolny schemat wbudowany i odczytuje dane do istniejącego DataSet schematu. Jeśli jakiekolwiek dane nie są zgodne z istniejącym schematem, zostaną odrzucone (w tym dane z różnych przestrzeni nazw zdefiniowanych dla elementu DataSet). Jeśli dane są DiffGram, IgnoreSchema mają taką samą funkcjonalność jak DiffGram.
InferSchema	3	Ignoruje dowolny schemat wbudowany, wywnioskuje schemat z danych i ładuje dane. DataSet Jeśli schemat zawiera już schemat, bieżący schemat zostanie rozszerzony przez dodanie nowych tabel lub dodanie kolumn do istniejących tabel. Zgłaszany jest wyjątek, jeśli wywnioskowana tabela już istnieje, ale z inną przestrzenią nazw lub jeśli którakolwiek z wywnioskowanych kolumn jest sprzeczna z istniejącymi kolumnami.
DiffGram	4	Odczytuje diffGram, stosując zmiany z DiffGram do .DataSet Semantyka jest taka sama jak Merge(DataSet) semantyka operacji. Podobnie jak w przypadku Merge(DataSet) operacji, RowState wartości są zachowywane. Dane wejściowe z ReadXml(XmlReader) diffGramami powinny być uzyskiwane tylko przy użyciu danych wyjściowych WriteXml(Stream) jako DiffGram. Obiekt docelowy DataSet musi mieć ten sam schemat co DataSet nazwa WriteXml DiffGram. W przeciwnym razie operacja scalania DiffGram kończy się niepowodzeniem i zgłaszany jest wyjątek.
Fragment	5	Odczytuje fragmenty XML, takie jak te wygenerowane przez wykonywanie zapytań FOR XML, względem wystąpienia SQL Server. Gdy XmlReadMode jest ustawiona wartość Fragment, domyślna przestrzeń nazw jest odczytywana jako schemat wbudowany.
InferTypedSchema	6	Ignoruje dowolny schemat wbudowany, wywnioskuje silnie typizowane schematy z danych i ładuje dane. Jeśli nie można wywnioskować typu z danych, jest interpretowany jako dane ciągu. DataSet Jeśli obiekt zawiera już schemat, bieżący schemat jest rozszerzony, dodając nowe tabele lub dodając kolumny do istniejących tabel. Zgłaszany jest wyjątek, jeśli wywnioskowana tabela już istnieje, ale z inną przestrzenią nazw lub jeśli którakolwiek z wywnioskowanych kolumn jest sprzeczna z istniejącymi kolumnami.

Uwagi

Użyj elementów członkowskich tej wyliczenia podczas ustawiania ReadMode parametru DataSet.ReadXml metody.

Note

Auto tryb może być wolniejszy niż ustawienie XmlReadMode opcji jawnej.

Auto wykonuje najwłaściwsze z tych akcji:

• Jeśli dane są DiffGram, ustawia tryb odczytu XML na DiffGram.

• Jeśli zestaw danych ma już schemat lub jeśli dokument zawiera schemat wbudowany, ustawia tryb odczytu XML na ReadSchema.

• Jeśli zestaw danych nie ma jeszcze schematu, a dokument nie zawiera schematu wbudowanego, ustawia tryb odczytu XML na InferSchemawartość .