XmlReadMode Enumeração

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Especifica como ler dados XML e um esquema relacional num DataSet.

public enum class XmlReadMode
public enum XmlReadMode
type XmlReadMode = 
Public Enum XmlReadMode
Herança
Object
ValueType
Enum
XmlReadMode

Campos

Name Valor Description
Auto 0

O modo de leitura padrão.
ReadSchema 1

Lê qualquer esquema inline e carrega os dados. Se o DataSet já contiver, novas tabelas podem ser adicionadas ao esquema, mas uma exceção é lançada se existirem tabelas no esquema DataSetinline no .
IgnoreSchema 2

Ignora qualquer esquema inline e lê dados no esquema existente DataSet . Se algum dado não corresponder ao esquema existente, é descartado (incluindo dados de diferentes namespaces definidos para o DataSet). Se os dados forem um DiffGram, IgnoreSchema tem a mesma funcionalidade que DiffGram.
InferSchema 3

Ignora qualquer esquema inline, infere o esquema a partir dos dados e carrega os dados. Se já DataSet contiver um esquema, o esquema atual é estendido adicionando novas tabelas ou colunas às tabelas existentes. É lançada uma exceção se a tabela inferida já existir mas com um namespace diferente, ou se alguma das colunas inferidas entrar em conflito com colunas existentes.
DiffGram 4

Lê um DiffGram, aplicando alterações do DiffGram para o DataSet. A semântica é idêntica à de uma Merge(DataSet) operação. Tal como na Merge(DataSet) operação, RowState os valores são preservados. A entrada para ReadXml(XmlReader) com DiffGrams deve ser obtida apenas usando a saída de WriteXml(Stream) como um DiffGram.

O alvo DataSet deve ter o mesmo esquema que DataSet o em que WriteXml o DiffGram é chamado. Caso contrário, a operação de fusão DiffGram falha e é lançada uma exceção.
Fragment 5

Lê fragmentos XML, como os gerados pela execução de consultas XML FOR, contra uma instância do SQL Server. Quando XmlReadMode está definido para Fragment, o namespace padrão é lido como o esquema inline.
InferTypedSchema 6

Ignora qualquer esquema inline, infere um esquema fortemente tipado a partir dos dados e carrega os dados. Se o tipo não puder ser inferido a partir dos dados, é interpretado como dados de cadeia. Se já DataSet contiver um esquema, o esquema atual é estendido, seja adicionando novas tabelas ou adicionando colunas a tabelas existentes. É lançada uma exceção se a tabela inferida já existir mas com um namespace diferente, ou se alguma das colunas inferidas entrar em conflito com colunas existentes.

Observações

Use os membros desta enumeração ao definir o ReadMode parâmetro do DataSet.ReadXml método.

Note

Auto O modo pode ser mais lento do que definir XmlReadMode para uma opção explícita.

Auto realiza a ação mais apropriada destas ações:

  • Se os dados forem um DiffGram, define o modo de leitura XML para DiffGram.

  • Se o conjunto de dados já tiver um esquema, ou se o documento contiver um esquema em linha, define o modo de leitura XML para ReadSchema.

  • Se o conjunto de dados ainda não tiver um esquema e o documento não contiver um esquema em linha, define o modo de leitura XML para InferSchema.

Aplica-se a