XmlDataDocument.Load Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Data.Common.dll

Carga mediante XmlDataDocument el origen de datos especificado y sincroniza con DataSet los datos cargados.

Sobrecargas

Nombre	Description
Load(Stream)	Carga desde XmlDataDocument la secuencia especificada.
Load(TextReader)	Carga desde XmlDataDocument el especificado TextReader.
Load(String)	Carga mediante XmlDataDocument la dirección URL especificada.
Load(XmlReader)	Carga desde XmlDataDocument el especificado XmlReader.

Comentarios

Nota:

Para ver los datos XML de forma relacional, primero debe especificar un esquema que se usará para la asignación de datos. Esto se puede hacer llamando al ReadXmlSchema método o creando las tablas y columnas manualmente DataSet . Este paso debe realizarse antes de llamar a Load.

XmlDataDocument no admite la creación de referencias de entidad. Si los datos incluyen referencias de entidad, el Load método resuelve y expande las referencias de entidad. Sin embargo, si usa la Load sobrecarga que toma como XmlReader argumento , debe especificar un XmlReader que pueda resolver entidades.

Load(Stream)

Source:

XmlDataDocument.cs

Carga desde XmlDataDocument la secuencia especificada.

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

Secuencia que contiene el documento XML que se va a cargar.

Comentarios

XmlDataDocument no admite la creación de referencias de entidad. Si los datos incluyen referencias de entidad, el Load método resuelve y expande las referencias de entidad.

Nota:

Para ver los datos XML de forma relacional, primero debe especificar un esquema que se usará para la asignación de datos. Esto se puede hacer llamando al ReadXmlSchema método o creando las tablas y columnas manualmente DataSet . Este paso debe realizarse antes de llamar a Load.

Load(TextReader)

Source:

XmlDataDocument.cs

Carga desde XmlDataDocument el 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

TextReader que se usa para alimentar los datos XML en el documento.

Comentarios

XmlDataDocument no admite la creación de referencias de entidad. Si los datos incluyen referencias de entidad, el Load método resuelve y expande las referencias de entidad.

Nota:

Para ver los datos XML de forma relacional, primero debe especificar un esquema que se usará para la asignación de datos. Esto se puede hacer llamando al ReadXmlSchema método o creando las tablas y columnas manualmente DataSet . Este paso debe realizarse antes de llamar a Load.

Load(String)

Source:

XmlDataDocument.cs

Carga mediante XmlDataDocument la dirección 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

Dirección URL del archivo que contiene el documento XML que se va a cargar.

Comentarios

XmlDataDocument no admite la creación de referencias de entidad. Si los datos incluyen referencias de entidad, el Load método resuelve y expande las referencias de entidad.

Nota:

Para ver los datos XML de forma relacional, primero debe especificar un esquema que se usará para la asignación de datos. Esto se puede hacer llamando al ReadXmlSchema método o creando las tablas y columnas manualmente DataSet . Este paso debe realizarse antes de llamar a Load.

Load(XmlReader)

Source:

XmlDataDocument.cs

Carga desde XmlDataDocument el 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

XmlReader que contiene el documento XML que se va a cargar.

Excepciones

NotSupportedException

El XML que se carga contiene referencias de entidad y el lector no puede resolver entidades.

Comentarios

XmlDataDocument no admite la creación de referencias de entidad. Si el origen de datos contiene referencias de entidad, debe crear un XmlValidatingReader con la EntityHandling propiedad establecida en EntityHandling.ExpandEntities (este es el comportamiento predeterminado) y pasar al LoadXmlValidatingReader método . Si no usa un XmlValidatingReader, el Load método produce una excepción.

El Load método siempre conserva un espacio en blanco significativo. La PreserveWhitespace propiedad determina si se conserva o no el espacio en blanco. El valor predeterminado es false, no se conserva el espacio en blanco.

Si el lector está en estado inicial (es decir, ReadState=ReadState.Initial), Load consume todo el contenido del lector y compila el DOM a partir de lo que encuentra.

Si el lector ya está colocado en algún nodo en la profundidad "n", este método carga ese nodo y todos los elementos del mismo nivel posteriores hasta la etiqueta final que cierra la profundidad "n". Esto tiene los siguientes resultados.

Si el nodo actual y sus siguientes elementos relacionados tienen un aspecto similar al siguiente:

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

Load produce una excepción, porque un documento no puede tener dos elementos de nivel raíz. Si el nodo actual y sus siguientes elementos relacionados tienen un aspecto similar al siguiente:

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

Load se realizará correctamente; sin embargo, tendrá un árbol DOM incompleto, ya que no hay ningún elemento de nivel raíz. Debe agregar un elemento de nivel raíz antes de guardar el documento; De lo contrario, el Save método produce una excepción.

Si el lector se coloca en un nodo de hoja que no es válido para el nivel raíz de un documento (por ejemplo, un espacio en blanco o un nodo de atributo), el lector continúa leyendo hasta que quede en un nodo que pueda usarse como raíz. El documento comienza a cargarse en este momento.