DataSet.ReadXml Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Lee esquema y datos XML en el objeto DataSet.
Sobrecargas
ReadXml(XmlReader, XmlReadMode) |
Lee el esquema y los datos XML del objeto DataSet mediante el objeto XmlReader y la enumeración XmlReadMode especificados. |
ReadXml(String, XmlReadMode) |
Lee el esquema y los datos XML del DataSet mediante el archivo y el XmlReadMode especificados. |
ReadXml(Stream, XmlReadMode) |
Lee el esquema y los datos XML del objeto DataSet mediante el objeto Stream y la enumeración XmlReadMode especificados. |
ReadXml(TextReader, XmlReadMode) |
Lee el esquema y los datos XML del objeto DataSet mediante el objeto TextReader y la enumeración XmlReadMode especificados. |
ReadXml(String) |
Lee el esquema y los datos XML del DataSet mediante el archivo especificado. |
ReadXml(TextReader) |
Lee los datos y el esquema XML en el objeto DataSet mediante el objeto TextReader especificado. |
ReadXml(Stream) |
Lee los datos y el esquema XML en el objeto DataSet mediante el objeto Stream especificado. |
ReadXml(XmlReader) |
Lee los datos y el esquema XML en el objeto DataSet mediante el objeto XmlReader especificado. |
ReadXml(XmlReader, XmlReadMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
Lee el esquema y los datos XML del objeto DataSet mediante el objeto XmlReader y la enumeración XmlReadMode especificados.
public:
System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode
Parámetros
- mode
- XmlReadMode
Uno de los valores de XmlReadMode.
Devoluciones
XmlReadMode
utilizado para leer los datos.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un desde un DataSet documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo ocurre con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para extender la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
no DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo aplica caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML se escapan, el elemento se omite durante el procesamiento.
Si el esquema XML de un DataSet objeto incluye , targetNamespace
es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin espacio de nombres apto. Para leer elementos no completos, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema en con DataSet especificando ReadXmlXmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
Se aplica a
ReadXml(String, XmlReadMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
Lee el esquema y los datos XML del DataSet mediante el archivo y el XmlReadMode especificados.
public:
System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (string fileName, System.Data.XmlReadMode mode);
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String, mode As XmlReadMode) As XmlReadMode
Parámetros
- fileName
- String
Nombre del archivo (incluida la ruta) desde el que se va a leer.
- mode
- XmlReadMode
Uno de los valores de XmlReadMode.
Devoluciones
XmlReadMode
utilizado para leer los datos.
Excepciones
FileIOPermission no está establecido en Read.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un desde un DataSet documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo ocurre con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para extender la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
no DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo aplica caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML se escapan, el elemento se omite durante el procesamiento.
Si el esquema XML de un DataSet objeto incluye , targetNamespace
es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin espacio de nombres apto. Para leer elementos no completos, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema en con DataSet especificando ReadXmlXmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
Se aplica a
ReadXml(Stream, XmlReadMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
Lee el esquema y los datos XML del objeto DataSet mediante el objeto Stream y la enumeración XmlReadMode especificados.
public:
System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream, mode As XmlReadMode) As XmlReadMode
Parámetros
- mode
- XmlReadMode
Uno de los valores de XmlReadMode.
Devoluciones
XmlReadMode
utilizado para leer los datos.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un desde un DataSet documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
Cuando se usa ReadXml y se establece XmlReadMode en Diffgram
, el contenido del destino DataSet
y el original DataSet
pueden diferir debido a cómo se genera y procesa el diffgram. Para obtener más información sobre los diffgramas, consulte DiffGrams.
Nota
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para extender la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
no DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo aplica caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML se escapan, el elemento se omite durante el procesamiento.
Si el esquema XML de un DataSet objeto incluye targetNamespace
, es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin espacio de nombres calificado. Para leer elementos no completos, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de un tipo diferente, en el mismo espacio de nombres, se produce una excepción al intentar leer el esquema en con DataSet especificando ReadXmlXmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
Se aplica a
ReadXml(TextReader, XmlReadMode)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
Lee el esquema y los datos XML del objeto DataSet mediante el objeto TextReader y la enumeración XmlReadMode especificados.
public:
System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader, mode As XmlReadMode) As XmlReadMode
Parámetros
- reader
- TextReader
Objeto TextReader desde el que se va a leer.
- mode
- XmlReadMode
Uno de los valores de XmlReadMode.
Devoluciones
XmlReadMode
utilizado para leer los datos.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un DataSet desde un documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo es true para los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
InvalidOperationException Se producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para ampliar la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
No DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo escapa a caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML son de escape, el elemento se omite mientras se procesa.
Si el esquema XML de un DataSet elemento incluye targetNamespace
, es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin ningún espacio de nombres apto. Para leer elementos no calificados, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de tipo diferente, en el mismo espacio de nombres, se produce una excepción cuando se intenta leer el esquema en DataSet con ReadXml especificando XmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
Se aplica a
ReadXml(String)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
Lee el esquema y los datos XML del DataSet mediante el archivo especificado.
public:
System::Data::XmlReadMode ReadXml(System::String ^ fileName);
public System.Data.XmlReadMode ReadXml (string fileName);
member this.ReadXml : string -> System.Data.XmlReadMode
Public Function ReadXml (fileName As String) As XmlReadMode
Parámetros
- fileName
- String
Nombre del archivo (incluida la ruta) desde el que se va a leer.
Devoluciones
XmlReadMode
utilizado para leer los datos.
Excepciones
FileIOPermission no está establecido en Read.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El esquema y los DataSet datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el método se usa para rellenarlo con el esquema y los ReadXml datos.
private void DemonstrateReadWriteXMLDocumentWithStreamReader()
{
// Create a DataSet with one table and two columns.
DataSet OriginalDataSet = new DataSet("dataSet");
OriginalDataSet.Namespace= "NetFrameWork";
DataTable table = new DataTable("table");
DataColumn idColumn = new DataColumn("id",
Type.GetType("System.Int32"));
idColumn.AutoIncrement= true;
DataColumn itemColumn = new DataColumn("item");
table.Columns.Add(idColumn);
table.Columns.Add(itemColumn);
OriginalDataSet.Tables.Add(table);
// Add ten rows.
DataRow newRow;
for(int i = 0; i < 10; i++)
{
newRow = table.NewRow();
newRow["item"]= "item " + i;
table.Rows.Add(newRow);
}
OriginalDataSet.AcceptChanges();
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(OriginalDataSet, "Original DataSet");
// Write the schema and data to an XML file.
string xmlFilename = "XmlDocument.xml";
// Use WriteXml to write the document.
OriginalDataSet.WriteXml(xmlFilename);
// Dispose of the original DataSet.
OriginalDataSet.Dispose();
// Create a new DataSet.
DataSet newDataSet = new DataSet("New DataSet");
// Read the XML document into the DataSet.
newDataSet.ReadXml(xmlFilename);
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(newDataSet,"New DataSet");
}
private void PrintValues(DataSet dataSet, string label)
{
Console.WriteLine("\n" + label);
foreach(DataTable table in dataSet.Tables)
{
Console.WriteLine("TableName: " + table.TableName);
foreach(DataRow row in table.Rows)
{
foreach(DataColumn column in table.Columns)
{
Console.Write("\table " + row[column] );
}
Console.WriteLine();
}
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithStreamReader()
' Create a DataSet with one table and two columns.
Dim OriginalDataSet As New DataSet("dataSet")
OriginalDataSet.Namespace = "NetFrameWork"
Dim table As New DataTable("table")
Dim idColumn As New DataColumn("id", _
Type.GetType("System.Int32"))
idColumn.AutoIncrement = True
Dim itemColumn As New DataColumn("item")
table.Columns.Add(idColumn)
table.Columns.Add(itemColumn)
OriginalDataSet.Tables.Add(table)
' Add ten rows.
Dim newRow As DataRow
Dim i As Integer
For i = 0 To 9
newRow = table.NewRow()
newRow("item") = "item " & i.ToString()
table.Rows.Add(newRow)
Next i
OriginalDataSet.AcceptChanges()
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(OriginalDataSet, "Original DataSet")
' Write the schema and data to an XML file.
Dim xmlFilename As String = "XmlDocument.xml"
' Use WriteXml to write the document.
OriginalDataSet.WriteXml(xmlFilename)
' Dispose of the original DataSet.
OriginalDataSet.Dispose()
' Create a new DataSet.
Dim newDataSet As New DataSet("New DataSet")
' Read the XML document into the DataSet.
newDataSet.ReadXml(xmlFilename)
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(newDataSet, "New DataSet")
End Sub
Private Sub PrintValues(dataSet As DataSet, label As String)
Console.WriteLine(ControlChars.Cr & label)
Dim table As DataTable
For Each table In dataSet.Tables
Console.WriteLine("TableName: " & table.TableName)
Dim row As DataRow
For Each row In table.Rows
Dim column As DataColumn
For Each column In table.Columns
Console.Write(ControlChars.Tab & " " & _
row(column).ToString())
Next column
Console.WriteLine()
Next row
Next table
End Sub
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un DataSet desde un documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo es true para los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
InvalidOperationException Se producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para ampliar la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
No DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo escapa a caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML son de escape, el elemento se omite mientras se procesa.
Si el esquema XML de un DataSet objeto incluye , targetNamespace
es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin espacio de nombres apto. Para leer elementos no calificados, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de tipo diferente, en el mismo espacio de nombres, se produce una excepción cuando se intenta leer el esquema en DataSet con ReadXml especificando XmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
Se aplica a
ReadXml(TextReader)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
Lee los datos y el esquema XML en el objeto DataSet mediante el objeto TextReader especificado.
public:
System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader);
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As TextReader) As XmlReadMode
Parámetros
- reader
- TextReader
TextReader
desde el que se van a leer el esquema y los datos.
Devoluciones
XmlReadMode utilizado para leer los datos.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El esquema y los DataSet datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el método se usa para rellenarlo con el esquema y los ReadXml datos.
private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
// Create a DataSet with one table and two columns.
DataSet originalDataSet = new DataSet("dataSet");
DataTable table = new DataTable("table");
DataColumn idColumn = new DataColumn("id",
Type.GetType("System.Int32"));
idColumn.AutoIncrement= true;
DataColumn itemColumn = new DataColumn("item");
table.Columns.Add(idColumn);
table.Columns.Add(itemColumn);
originalDataSet.Tables.Add(table);
// Add ten rows.
DataRow newRow;
for(int i = 0; i < 10; i++)
{
newRow = table.NewRow();
newRow["item"]= "item " + i;
table.Rows.Add(newRow);
}
originalDataSet.AcceptChanges();
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(originalDataSet, "Original DataSet");
// Write the schema and data to XML file with FileStream.
string xmlFilename = "XmlDocument.xml";
System.IO.FileStream streamWrite = new System.IO.FileStream
(xmlFilename, System.IO.FileMode.Create);
// Use WriteXml to write the XML document.
originalDataSet.WriteXml(streamWrite);
// Close the FileStream.
streamWrite.Close();
// Dispose of the original DataSet.
originalDataSet.Dispose();
// Create a new DataSet.
DataSet newDataSet = new DataSet("New DataSet");
// Read the XML document back in.
// Create new FileStream to read schema with.
System.IO.FileStream streamRead = new System.IO.FileStream
(xmlFilename,System.IO.FileMode.Open);
newDataSet.ReadXml(streamRead);
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(newDataSet,"New DataSet");
}
private void PrintValues(DataSet dataSet, string label)
{
Console.WriteLine("\n" + label);
foreach(DataTable table in dataSet.Tables)
{
Console.WriteLine("TableName: " + table.TableName);
foreach(DataRow row in table.Rows)
{
foreach(DataColumn column in table.Columns)
{
Console.Write("\table " + row[column] );
}
Console.WriteLine();
}
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
' Create a DataSet with one table and two columns.
Dim originalDataSet As New DataSet("dataSet")
Dim table As New DataTable("table")
Dim idColumn As New DataColumn("id", _
Type.GetType("System.Int32"))
idColumn.AutoIncrement = True
Dim itemColumn As New DataColumn("item")
table.Columns.Add(idColumn)
table.Columns.Add(itemColumn)
originalDataSet.Tables.Add(table)
' Add ten rows.
Dim newRow As DataRow
Dim i As Integer
For i = 0 To 9
newRow = table.NewRow()
newRow("item") = "item " & i.ToString()
table.Rows.Add(newRow)
Next i
originalDataSet.AcceptChanges()
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(originalDataSet, "Original DataSet")
' Write the schema and data to XML file with FileStream.
Dim xmlFilename As String = "XmlDocument.xml"
Dim streamWrite As New System.IO.FileStream _
(xmlFilename, System.IO.FileMode.Create)
' Use WriteXml to write the XML document.
originalDataSet.WriteXml(streamWrite)
' Close the FileStream.
streamWrite.Close()
' Dispose of the original DataSet.
originalDataSet.Dispose()
' Create a new DataSet.
Dim newDataSet As New DataSet("New DataSet")
' Read the XML document back in.
' Create new FileStream to read schema with.
Dim streamRead As New System.IO.FileStream _
(xmlFilename, System.IO.FileMode.Open)
newDataSet.ReadXml(streamRead)
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(newDataSet, "New DataSet")
End Sub
Private Sub PrintValues(dataSet As DataSet, label As String)
Console.WriteLine(ControlChars.Cr & label)
Dim table As DataTable
Dim row As DataRow
Dim column As DataColumn
For Each table In dataSet.Tables
Console.WriteLine("TableName: " & table.TableName)
For Each row In table.Rows
For Each column In table.Columns
Console.Write(ControlChars.Tab & " " & _
row(column).ToString())
Next column
Console.WriteLine()
Next row
Next table
End Sub
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un DataSet desde un documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo es true para los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
InvalidOperationException Se producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para ampliar la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
No DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo escapa a caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML son de escape, el elemento se omite mientras se procesa.
Si el esquema XML de un DataSet elemento incluye targetNamespace
, es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin ningún espacio de nombres apto. Para leer elementos no calificados, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Las clases que heredan de la TextReader clase incluyen las StreamReader clases y StringReader .
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de tipo diferente, en el mismo espacio de nombres, se produce una excepción cuando se intenta leer el esquema en DataSet con ReadXml especificando XmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
Se aplica a
ReadXml(Stream)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
public:
System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream) As XmlReadMode
Parámetros
Devoluciones
XmlReadMode utilizado para leer los datos.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El esquema y los DataSet datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el método se usa para rellenarlo con el esquema y los ReadXml datos.
private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
// Create a DataSet with one table and two columns.
DataSet originalDataSet = new DataSet("dataSet");
DataTable table = new DataTable("table");
DataColumn idColumn = new DataColumn("id",
Type.GetType("System.Int32"));
idColumn.AutoIncrement= true;
DataColumn itemColumn = new DataColumn("item");
table.Columns.Add(idColumn);
table.Columns.Add(itemColumn);
originalDataSet.Tables.Add(table);
// Add ten rows.
DataRow newRow;
for(int i = 0; i < 10; i++)
{
newRow = table.NewRow();
newRow["item"]= "item " + i;
table.Rows.Add(newRow);
}
originalDataSet.AcceptChanges();
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(originalDataSet, "Original DataSet");
// Write the schema and data to XML file with FileStream.
string xmlFilename = "XmlDocument.xml";
System.IO.FileStream streamWrite = new System.IO.FileStream
(xmlFilename, System.IO.FileMode.Create);
// Use WriteXml to write the XML document.
originalDataSet.WriteXml(streamWrite);
// Close the FileStream.
streamWrite.Close();
// Dispose of the original DataSet.
originalDataSet.Dispose();
// Create a new DataSet.
DataSet newDataSet = new DataSet("New DataSet");
// Read the XML document back in.
// Create new FileStream to read schema with.
System.IO.FileStream streamRead = new System.IO.FileStream
(xmlFilename,System.IO.FileMode.Open);
newDataSet.ReadXml(streamRead);
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(newDataSet,"New DataSet");
}
private void PrintValues(DataSet dataSet, string label)
{
Console.WriteLine("\n" + label);
foreach(DataTable table in dataSet.Tables)
{
Console.WriteLine("TableName: " + table.TableName);
foreach(DataRow row in table.Rows)
{
foreach(DataColumn column in table.Columns)
{
Console.Write("\table " + row[column] );
}
Console.WriteLine();
}
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
' Create a DataSet with one table and two columns.
Dim originalDataSet As New DataSet("dataSet")
Dim table As New DataTable("table")
Dim idColumn As New DataColumn("id", _
Type.GetType("System.Int32"))
idColumn.AutoIncrement = True
Dim itemColumn As New DataColumn("item")
table.Columns.Add(idColumn)
table.Columns.Add(itemColumn)
originalDataSet.Tables.Add(table)
' Add ten rows.
Dim newRow As DataRow
Dim i As Integer
For i = 0 To 9
newRow = table.NewRow()
newRow("item") = "item " & i.ToString()
table.Rows.Add(newRow)
Next i
originalDataSet.AcceptChanges()
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(originalDataSet, "Original DataSet")
' Write the schema and data to XML file with FileStream.
Dim xmlFilename As String = "XmlDocument.xml"
Dim streamWrite As New System.IO.FileStream _
(xmlFilename, System.IO.FileMode.Create)
' Use WriteXml to write the XML document.
originalDataSet.WriteXml(streamWrite)
' Close the FileStream.
streamWrite.Close()
' Dispose of the original DataSet.
originalDataSet.Dispose()
' Create a new DataSet.
Dim newDataSet As New DataSet("New DataSet")
' Read the XML document back in.
' Create new FileStream to read schema with.
Dim streamRead As New System.IO.FileStream _
(xmlFilename, System.IO.FileMode.Open)
newDataSet.ReadXml(streamRead)
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(newDataSet, "New DataSet")
End Sub
Private Sub PrintValues(dataSet As DataSet, label As String)
Console.WriteLine(ControlChars.Cr & label)
Dim table As DataTable
Dim row As DataRow
Dim column As DataColumn
For Each table In dataSet.Tables
Console.WriteLine("TableName: " & table.TableName)
For Each row In table.Rows
For Each column In table.Columns
Console.Write(ControlChars.Tab & " " & _
row(column).ToString())
Next column
Console.WriteLine()
Next row
Next table
End Sub
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un DataSet desde un documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo es true para los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
InvalidOperationException Se producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para ampliar la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
No DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo escapa a caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML son de escape, el elemento se omite mientras se procesa.
Si el esquema XML de un DataSet elemento incluye targetNamespace
, es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin ningún espacio de nombres apto. Para leer elementos no calificados, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de tipo diferente, en el mismo espacio de nombres, se produce una excepción cuando se intenta leer el esquema en DataSet con ReadXml especificando XmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.
Consulte también
- ReadXmlSchema(XmlReader)
- WriteXml(Stream)
- WriteXmlSchema(Stream)
- Uso de conjuntos de datos en ADO.NET
Se aplica a
ReadXml(XmlReader)
- Source:
- DataSet.cs
- Source:
- DataSet.cs
- Source:
- DataSet.cs
public:
System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode
Parámetros
Devoluciones
XmlReadMode
utilizado para leer los datos.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El esquema y los DataSet datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el método se usa para rellenarlo con el esquema y los ReadXml datos.
private void DemonstrateReadWriteXMLDocumentWithXMLReader()
{
// Create a DataSet with one table and two columns.
DataSet OriginalDataSet = new DataSet("dataSet");
OriginalDataSet.Namespace= "NetFrameWork";
DataTable table = new DataTable("table");
DataColumn idColumn = new DataColumn("id",
Type.GetType("System.Int32"));
idColumn.AutoIncrement= true;
DataColumn itemColumn = new DataColumn("item");
table.Columns.Add(idColumn);
table.Columns.Add(itemColumn);
OriginalDataSet.Tables.Add(table);
// Add ten rows.
DataRow newRow;
for(int i = 0; i < 10; i++)
{
newRow = table.NewRow();
newRow["item"]= "item " + i;
table.Rows.Add(newRow);
}
OriginalDataSet.AcceptChanges();
// Print out values of each table in the DataSet
// using the function defined below.
PrintValues(OriginalDataSet, "Original DataSet");
// Write the XML schema and data to file with FileStream.
string xmlFilename = "XmlDocument.xml";
// Create FileStream
System.IO.FileStream fsWriteXml =
new System.IO.FileStream
(xmlFilename, System.IO.FileMode.Create);
// Create an XmlTextWriter to write the file.
System.Xml.XmlTextWriter xmlWriter =
new System.Xml.XmlTextWriter
(fsWriteXml, System.Text.Encoding.Unicode);
// Use WriteXml to write the document.
OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema);
// Close the FileStream.
fsWriteXml.Close();
// Dispose of the original DataSet.
OriginalDataSet.Dispose();
// Create a new DataSet.
DataSet newDataSet = new DataSet("New DataSet");
// Read the XML document back in.
// Create new FileStream to read schema with.
System.IO.FileStream fsReadXml =
new System.IO.FileStream
(xmlFilename, System.IO.FileMode.Open);
// Create an XmlTextReader to read the file.
System.Xml.XmlTextReader xmlReader =
new System.Xml.XmlTextReader(fsReadXml);
// Read the XML document into the DataSet.
newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema);
// Close the XmlTextReader
xmlReader.Close();
// Print out values of each table in the DataSet
// fusing the unction defined below.
PrintValues(newDataSet,"New DataSet");
}
private void PrintValues(DataSet dataSet, string label)
{
Console.WriteLine("\n" + label);
foreach(DataTable table in dataSet.Tables)
{
Console.WriteLine("TableName: " + table.TableName);
foreach(DataRow row in table.Rows)
{
foreach(DataColumn column in table.Columns)
{
Console.Write("\t{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row[column]);
}
Console.WriteLine();
}
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithXMLReader()
' Create a DataSet with one table and two columns.
Dim OriginalDataSet As New DataSet("dataSet")
OriginalDataSet.Namespace = "NetFrameWork"
Dim table As New DataTable("table")
Dim idColumn As New DataColumn("id", _
Type.GetType("System.Int32"))
idColumn.AutoIncrement = True
Dim itemColumn As New DataColumn("item")
table.Columns.Add(idColumn)
table.Columns.Add(itemColumn)
OriginalDataSet.Tables.Add(table)
' Add ten rows.
Dim newRow As DataRow
Dim i As Integer
For i = 0 To 9
newRow = table.NewRow()
newRow("item") = "item " & i.ToString()
table.Rows.Add(newRow)
Next i
OriginalDataSet.AcceptChanges()
' Print out values of each table in the DataSet
' using the function defined below.
PrintValues(OriginalDataSet, "Original DataSet")
' Write the XML schema and data to file with FileStream.
Dim xmlFilename As String = "XmlDocument.xml"
' Create FileStream
Dim fsWriteXml As New System.IO.FileStream _
(xmlFilename, System.IO.FileMode.Create)
' Create an XmlTextWriter to write the file.
Dim xmlWriter As New System.Xml.XmlTextWriter _
(fsWriteXml, System.Text.Encoding.Unicode)
' Use WriteXml to write the document.
OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema)
' Close the FileStream.
fsWriteXml.Close()
' Dispose of the original DataSet.
OriginalDataSet.Dispose()
' Create a new DataSet.
Dim newDataSet As New DataSet("New DataSet")
' Read the XML document back in.
' Create new FileStream to read schema with.
Dim fsReadXml As New System.IO.FileStream _
(xmlFilename, System.IO.FileMode.Open)
' Create an XmlTextReader to read the file.
Dim xmlReader As New System.Xml.XmlTextReader(fsReadXml)
' Read the XML document into the DataSet.
newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema)
' Close the XmlTextReader
xmlReader.Close()
' Print out values of each table in the DataSet using the
' function defined below.
PrintValues(newDataSet, "New DataSet")
End Sub
Private Sub PrintValues(dataSet As DataSet, label As String)
Console.WriteLine(ControlChars.Cr & label)
Dim table As DataTable
Dim row As DataRow
Dim column As DataColumn
For Each table In dataSet.Tables
Console.WriteLine("TableName: " & table.TableName)
For Each row In table.Rows
For Each column In table.Columns
Console.Write(ControlChars.Tab & "{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row(column).ToString())
Next column
Console.WriteLine()
Next row
Next table
End Sub
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o bien los datos y el esquema en un DataSet desde un documento XML, mientras que el ReadXmlSchema método solo lee el esquema. Para leer los datos y el esquema, use una de las ReadXML
sobrecargas que incluye el mode
parámetro y establezca su valor en ReadSchema
.
Tenga en cuenta que lo mismo es true para los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto el esquema como los datos de DataSet
, use el WriteXml
método . Para escribir solo el esquema, use el WriteXmlSchema
método .
Nota
InvalidOperationException Se producirá una excepción si un tipo de columna en el DataRow
que se lee o se escribe en implementa IDynamicMetaObjectProvider y no implementa IXmlSerializable.
Si se especifica un esquema en línea, el esquema en línea se usa para ampliar la estructura relacional existente antes de cargar los datos. Si hay conflictos (por ejemplo, la misma columna de la misma tabla definida con distintos tipos de datos), se genera una excepción.
Si no se especifica ningún esquema en línea, la estructura relacional se extiende a través de la inferencia, según sea necesario, según la estructura del documento XML. Si el esquema no se puede extender a través de la inferencia para exponer todos los datos, se genera una excepción.
Nota
No DataSet
asocia un elemento XML con su correspondiente DataColumn
o DataTable
cuando los caracteres XML legales como ("_") se escapan en el XML serializado. El DataSet
propio solo escapa a caracteres XML no válidos en los nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando los caracteres legales en el nombre del elemento XML son de escape, el elemento se omite mientras se procesa.
Si el esquema XML de un DataSet objeto incluye , targetNamespace
es posible que no se lean los datos y se produzcan excepciones al llamar ReadXml a para cargar con DataSet XML que contenga elementos sin espacio de nombres apto. Para leer elementos no calificados, establezca elementFormDefault
igual a "calificado" en el esquema XML, como se muestra en el ejemplo siguiente.
<xsd:schema id="MyDataSet"
elementFormDefault="qualified"
targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
xmlns="http://www.tempuri.org/MyDataSet.xsd"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>
System.Xml.XmlTextReader hereda de XmlReader.
Nota
Si el esquema de contiene DataSet elementos del mismo nombre, pero de tipo diferente, en el mismo espacio de nombres, se produce una excepción cuando se intenta leer el esquema en DataSet con ReadXml especificando XmlReadMode.ReadSchema
. Esta excepción no se produce si usa .NET Framework versión 1.0.