XmlDataDocument.Load Método

Definição

Namespace:

System.Xml

Assembly:

System.Data.Common.dll

Carrega o XmlDataDocument uso da fonte de dados especificada e sincroniza os DataSet dados carregados.

Sobrecargas

Nome	Description
Load(Stream)	Carrega o XmlDataDocument fluxo especificado.
Load(TextReader)	Carrega o XmlDataDocument da especificada TextReader.
Load(String)	Carrega o XmlDataDocument uso da URL especificada.
Load(XmlReader)	Carrega o XmlDataDocument da especificada XmlReader.

Comentários

Observação

Para exibir os dados XML relacionalmente, primeiro você deve especificar um esquema a ser usado para mapeamento de dados. Isso pode ser feito chamando o ReadXmlSchema método ou criando as tabelas e colunas no DataSet manualmente. Esta etapa deve ser feita antes de chamar Load.

XmlDataDocument não dá suporte à criação de referências de entidade. Se os dados incluirem referências de entidade, o Load método resolverá e expandirá as referências de entidade. No entanto, se você estiver usando a Load sobrecarga que usa um XmlReader argumento como argumento, deverá especificar um XmlReader que possa resolver entidades.

Load(Stream)

Origem:

XmlDataDocument.cs

Carrega o XmlDataDocument fluxo especificado.

public:
 override void Load(System::IO::Stream ^ inStream);

public override void Load(System.IO.Stream inStream);

override this.Load : System.IO.Stream -> unit

Public Overrides Sub Load (inStream As Stream)

Parâmetros

inStream

Stream

O fluxo que contém o documento XML a ser carregado.

Comentários

XmlDataDocument não dá suporte à criação de referências de entidade. Se os dados incluirem referências de entidade, o Load método resolverá e expandirá as referências de entidade.

Observação

Para exibir os dados XML relacionalmente, primeiro você deve especificar um esquema a ser usado para mapeamento de dados. Isso pode ser feito chamando o ReadXmlSchema método ou criando as tabelas e colunas no DataSet manualmente. Esta etapa deve ser feita antes de chamar Load.

Load(TextReader)

Origem:

XmlDataDocument.cs

Carrega o XmlDataDocument da especificada TextReader.

public:
 override void Load(System::IO::TextReader ^ txtReader);

public override void Load(System.IO.TextReader txtReader);

override this.Load : System.IO.TextReader -> unit

Public Overrides Sub Load (txtReader As TextReader)

Parâmetros

txtReader

TextReader

O TextReader usado para alimentar os dados XML no documento.

Comentários

XmlDataDocument não dá suporte à criação de referências de entidade. Se os dados incluirem referências de entidade, o Load método resolverá e expandirá as referências de entidade.

Observação

Para exibir os dados XML relacionalmente, primeiro você deve especificar um esquema a ser usado para mapeamento de dados. Isso pode ser feito chamando o ReadXmlSchema método ou criando as tabelas e colunas no DataSet manualmente. Esta etapa deve ser feita antes de chamar Load.

Load(String)

Origem:

XmlDataDocument.cs

Carrega o XmlDataDocument uso da URL especificada.

public:
 override void Load(System::String ^ filename);

public override void Load(string filename);

override this.Load : string -> unit

Public Overrides Sub Load (filename As String)

Parâmetros

filename

String

A URL do arquivo que contém o documento XML a ser carregado.

Comentários

XmlDataDocument não dá suporte à criação de referências de entidade. Se os dados incluirem referências de entidade, o Load método resolverá e expandirá as referências de entidade.

Observação

Para exibir os dados XML relacionalmente, primeiro você deve especificar um esquema a ser usado para mapeamento de dados. Isso pode ser feito chamando o ReadXmlSchema método ou criando as tabelas e colunas no DataSet manualmente. Esta etapa deve ser feita antes de chamar Load.

Load(XmlReader)

Origem:

XmlDataDocument.cs

Carrega o XmlDataDocument da especificada XmlReader.

public:
 override void Load(System::Xml::XmlReader ^ reader);

public override void Load(System.Xml.XmlReader reader);

override this.Load : System.Xml.XmlReader -> unit

Public Overrides Sub Load (reader As XmlReader)

Parâmetros

reader

XmlReader

O XmlReader documento XML que contém a ser carregado.

Exceções

NotSupportedException

O XML que está sendo carregado contém referências de entidade e o leitor não pode resolver entidades.

Comentários

XmlDataDocument não dá suporte à criação de referências de entidade. Se a fonte de dados contiver referências de entidade, você deverá criar uma XmlValidatingReader propriedade com a EntityHandling propriedade definida como EntityHandling.ExpandEntities (esse é o comportamento padrão) e passar para XmlValidatingReader o Load método. Se você não usar um XmlValidatingReader, o Load método gerará uma exceção.

O Load método sempre preserva um espaço em branco significativo. A PreserveWhitespace propriedade determina se o espaço em branco é ou não preservado. O padrão é falseque o espaço em branco não é preservado.

Se o leitor estiver no estado inicial (ou seja, ReadState=ReadState.Initial), Load consumirá todo o conteúdo do leitor e criará o DOM com base no que ele encontra.

Se o leitor já estiver posicionado em algum nó em profundidade "n", esse método carregará esse nó e todos os irmãos subsequentes até a marca final que fecha a profundidade "n". Isso tem os seguintes resultados.

Se o nó atual e seus irmãos a seguir forem semelhantes aos seguintes:

<!--comment--><element1>one</element1><element2>two</element2>

Load gera uma exceção, porque um documento não pode ter dois elementos de nível raiz. Se o nó atual e seus irmãos a seguir forem semelhantes aos seguintes:

<!--comment--><?process
    instruction?><!--comment--></endtag>

Load terá êxito; no entanto, você terá uma árvore DOM incompleta, porque não há nenhum elemento de nível raiz. Você precisa adicionar um elemento de nível raiz antes de salvar o documento; caso contrário, o Save método gera uma exceção.

Se o leitor é posicionado em um nó folha que não é válido para o nível raiz de um documento (por exemplo, um espaço em branco ou um nó de atributo), o leitor continua a ler até que está localizado em um nó que pode ser usado para a raiz. O documento começa a ser carregado neste ponto.