Compartilhar via


XmlReadMode Enumeração

Definição

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
XmlReadMode

Campos

Auto 0

O modo de leitura padrão.

DiffGram 4

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

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

Fragment 5

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

IgnoreSchema 2

Ignora qualquer esquema embutido e carrega os dados no esquema DataSet existente. Se os dados não coincidem com o esquema existente, eles serão descartados (incluindo dados de diferentes namespaces definidos para o DataSet). Se os dados forem um DiffGram, IgnoreSchema tem a funcionalidade que DiffGram.

InferSchema 3

Ignora qualquer esquema embutido, infere o esquema dos dados e carrega-os. Se o DataSet já contiver um esquema, o esquema atual será estendido, adicionando colunas às tabelas existentes. Uma exceção será lançada se uma tabela inferida já existir com um namespace diferente ou se qualquer coluna inferida estiver em conflito com colunas existentes.

InferTypedSchema 6

Ignora qualquer esquema embutido, infere o esquema digitado dos dados e carrega-os. Se o tipo não pode ser inferido dos dados, ele é interpretado como dados de cadeia de caracteres. Se o DataSet já contiver um esquema, o esquema atual é estendido, adicionando novas colunas ou adicionando colunas às tabelas existentes. Uma exceção será lançada se uma tabela inferida já existir com um namespace diferente ou se qualquer coluna inferida estiver em conflito com colunas existentes.

ReadSchema 1

Lê qualquer esquema embutido e carrega os dados. Se o DataSet já contém o esquema, novas tabelas podem ser adicionadas ao esquema, mas uma exceção é lançada se todas as tabelas no esquema embutido já existirem no DataSet.

Comentários

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

Observação

Auto O modo pode ser mais lento do que definir XmlReadMode como 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