XmlDataDocument.Load Método

Definição

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

Carrega o XmlDataDocument usando a fonte de dados especificada e sincroniza com DataSet os dados carregados.

Sobrecargas

Name Description
Load(Stream)

Carrega o XmlDataDocument a partir do fluxo especificado.
Load(TextReader)

Carrega o XmlDataDocument a partir do especificado TextReader.
Load(String)

Carrega o XmlDataDocument usando a URL especificada.
Load(XmlReader)

Carrega o XmlDataDocument a partir do especificado XmlReader.

Observações

Note

Para visualizar os dados XML relacionalmente, deve primeiro especificar um esquema a usar para o mapeamento de dados. Isto pode ser feito chamando o ReadXmlSchema método ou criando manualmente as tabelas e colunas dentro do DataSet processo. Este passo deve ser feito antes de ligar Load.

XmlDataDocument não suporta a criação de referências de entidades. Se os dados incluírem referências de entidade, o Load método resolve e expande quaisquer referências de entidade. No entanto, se estiver a usar a Load sobrecarga que toma a XmlReader como argumento, deve especificar um XmlReader que possa resolver as entidades.

Load(Stream)

Carrega o XmlDataDocument a partir do 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 contendo o documento XML para carregar.

Observações

XmlDataDocument não suporta a criação de referências de entidades. Se os dados incluírem referências de entidade, o Load método resolve e expande quaisquer referências de entidade.

Note

Para visualizar os dados XML relacionalmente, deve primeiro especificar um esquema a usar para o mapeamento de dados. Isto pode ser feito chamando o ReadXmlSchema método ou criando manualmente as tabelas e colunas dentro do DataSet processo. Este passo deve ser feito antes de ligar Load.

Aplica-se a

Load(TextReader)

Carrega o XmlDataDocument a partir do especificado 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

Eles TextReader são usados para alimentar os dados XML no documento.

Observações

XmlDataDocument não suporta a criação de referências de entidades. Se os dados incluírem referências de entidade, o Load método resolve e expande quaisquer referências de entidade.

Note

Para visualizar os dados XML relacionalmente, deve primeiro especificar um esquema a usar para o mapeamento de dados. Isto pode ser feito chamando o ReadXmlSchema método ou criando manualmente as tabelas e colunas dentro do DataSet processo. Este passo deve ser feito antes de ligar Load.

Aplica-se a

Load(String)

Carrega o XmlDataDocument usando a 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 ficheiro que contém o documento XML a carregar.

Observações

XmlDataDocument não suporta a criação de referências de entidades. Se os dados incluírem referências de entidade, o Load método resolve e expande quaisquer referências de entidade.

Note

Para visualizar os dados XML relacionalmente, deve primeiro especificar um esquema a usar para o mapeamento de dados. Isto pode ser feito chamando o ReadXmlSchema método ou criando manualmente as tabelas e colunas dentro do DataSet processo. Este passo deve ser feito antes de ligar Load.

Aplica-se a

Load(XmlReader)

Carrega o XmlDataDocument a partir do especificado 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 que contém o documento XML para carregar.

Exceções

NotSupportedException

O XML que está a ser carregado contém referências de entidades, e o leitor não pode resolver as entidades.

Observações

XmlDataDocument não suporta a criação de referências de entidades. Se a fonte de dados contiver referências de entidades, deve criar uma XmlValidatingReader com a EntityHandling propriedade definida como EntityHandling.ExpandEntities (este é o comportamento padrão) e passar para XmlValidatingReader o Load método. Se não usar um XmlValidatingReader, o Load método lança uma exceção.

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

Se o leitor estiver no estado inicial (ou seja, ReadState=ReadState.Initial), Load consome todo o conteúdo do leitor e constrói o DOM a partir do que encontrar.

Se o leitor já estiver posicionado num nó na profundidade "n", então este método carrega esse nó e todos os irmãos subsequentes até à tag final que fecha a profundidade "n". Isto tem os seguintes resultados.

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

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

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

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

Load terá sucesso; no entanto, terá uma árvore DOM incompleta, porque não existe elemento ao nível da raiz. Tens de adicionar um elemento ao nível da raiz antes de guardares o documento; caso contrário, o Save método lança uma exceção.

Se o leitor estiver posicionado numa folha que é inválida para o nível raiz de um documento (por exemplo, um espaço em branco ou nó de atributo), o leitor continuará a ler até estar posicionado num nó que possa ser usado como raiz. O documento começa a ser carregado neste momento.

Aplica-se a