XmlDataDocument.Load Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Carrega o XmlDataDocument uso da fonte de dados especificada e sincroniza os DataSet dados carregados.
Sobrecargas
| Nome | Description |
|---|---|
| Load(Stream) |
Carrega o |
| Load(TextReader) |
Carrega o |
| Load(String) |
Carrega o |
| Load(XmlReader) |
Carrega o |
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
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- 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 -> unitPublic 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.
Aplica-se a
Load(TextReader)
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- 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 -> unitPublic 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.
Aplica-se a
Load(String)
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- 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 -> unitPublic 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.
Aplica-se a
Load(XmlReader)
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- Origem:
- XmlDataDocument.cs
- 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 -> unitPublic Overrides Sub Load (reader As XmlReader)Parâmetros
- reader
- XmlReader
O XmlReader documento XML que contém a ser carregado.
Exceções
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.
