XmlReadMode Wyliczenie

Definicja

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

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Dziedziczenie
XmlReadMode

Pola

Auto 0

Domyślny tryb odczytu.

DiffGram 4

Odczytuje diffGram, stosując zmiany z DiffGram do .DataSet Semantyka jest taka sama jak Merge(DataSet) w przypadku operacji. Podobnie jak w przypadku Merge(DataSet) operacji, RowState wartości są zachowywane. Dane wejściowe z ReadXml(XmlReader) DiffGrams powinny być uzyskiwane tylko przy użyciu danych wyjściowych jako WriteXml(Stream) DiffGram.

Obiekt docelowy DataSet musi mieć taki sam schemat jak DataSetWriteXml nazwa 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 wykonanie zapytań FOR XML, względem wystąpienia SQL Server. Gdy XmlReadMode jest ustawiona wartość Fragment, domyślna przestrzeń nazw jest odczytywana jako schemat wbudowany.

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. Jeśli schemat DataSet zawiera już schemat, bieżący schemat jest rozszerzony przez dodanie nowych tabel lub dodanie kolumn do istniejących tabel. Wyjątek jest zgłaszany, 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.

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 on interpretowany jako dane ciągu. Jeśli schemat DataSet zawiera już schemat, bieżący schemat jest rozszerzony, dodając nowe tabele lub dodając kolumny do istniejących tabel. Wyjątek jest zgłaszany, 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.

ReadSchema 1

Odczytuje dowolny schemat wbudowany i ładuje dane. DataSet Jeśli schemat zawiera już schemat, nowe tabele mogą zostać dodane do schematu, ale zgłaszany jest wyjątek, jeśli w schemacie wbudowanym istnieją już tabele w schemacie wbudowanym DataSet.

Uwagi

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

Uwaga

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 w wierszu, ustawia tryb odczytu XML na InferSchema.

Dotyczy