XmlReadMode Enumeração

Definição

Namespace:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

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

Campos

Nome Valor Description
Auto 0

O modo de leitura padrão.
ReadSchema 1

Lê qualquer esquema embutido e carrega os dados. Se o DataSet esquema já contiver, novas tabelas poderão ser adicionadas ao esquema, mas uma exceção será gerada se alguma tabela no esquema embutido já existir no DataSet.
IgnoreSchema 2

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

Ignora qualquer esquema embutido, infere o esquema dos dados e carrega os dados. Se o DataSet esquema já contiver, o esquema atual será estendido adicionando novas tabelas ou adicionando colunas a tabelas existentes. Uma exceção será gerada se a tabela inferida já existir, mas com um namespace diferente ou se qualquer uma das colunas inferidas entrar em conflito com colunas existentes.
DiffGram 4

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

O destino DataSet deve ter o mesmo esquema no qual WriteXml diffGram DataSet é chamado. Caso contrário, a operação de mesclagem DiffGram falhará e uma exceção será gerada.
Fragment 5

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

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

Comentários

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

Note

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

Auto executa as ações mais apropriadas:

  • Se os dados forem um DiffGram, definirá o modo de leitura XML como DiffGram.

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

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

Aplica-se a