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 el esquema XML y los datos en .DataSet
Sobrecargas
| Nombre | Description |
|---|---|
| ReadXml(XmlReader, XmlReadMode) |
Lee el esquema XML y los datos en mediante DataSet el especificado XmlReader y XmlReadMode. |
| ReadXml(String, XmlReadMode) |
Lee el esquema XML y los datos en mediante DataSet el archivo especificado y XmlReadMode. |
| ReadXml(Stream, XmlReadMode) |
Lee el esquema XML y los datos en mediante DataSet el especificado Stream y XmlReadMode. |
| ReadXml(TextReader, XmlReadMode) |
Lee el esquema XML y los datos en mediante DataSet el especificado TextReader y XmlReadMode. |
| ReadXml(String) |
Lee el esquema XML y los datos en el DataSet utilizando el archivo especificado. |
| ReadXml(TextReader) |
Lee el esquema XML y los datos en mediante DataSet el especificado TextReader. |
| ReadXml(Stream) |
Lee el esquema XML y los datos en mediante DataSet el especificado Stream. |
| ReadXml(XmlReader) |
Lee el esquema XML y los datos en mediante DataSet el especificado XmlReader. |
ReadXml(XmlReader, XmlReadMode)
Lee el esquema XML y los datos en mediante DataSet el especificado XmlReader y XmlReadMode.
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 XmlReadMode valores.
Devoluciones
que XmlReadMode se usa para leer los datos.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento mientras se procesa.
Si el esquema XML de un DataSet elemento incluye , targetNamespacees 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 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>
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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, XmlReadMode)
Lee el esquema XML y los datos en mediante DataSet el archivo especificado y XmlReadMode.
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 de archivo (incluida la ruta de acceso) desde el que se va a leer.
- mode
- XmlReadMode
Uno de los XmlReadMode valores.
Devoluciones
que XmlReadMode se usa 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 tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento mientras se procesa.
Si el esquema XML de un DataSet elemento incluye , targetNamespacees 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 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>
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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, XmlReadMode)
Lee el esquema XML y los datos en mediante DataSet el especificado Stream y XmlReadMode.
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 XmlReadMode valores.
Devoluciones
que XmlReadMode se usa para leer los datos.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o tanto los datos como 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 ReadSchemaen .
Lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Cuando se usa ReadXml y se establece en DiffgramXmlReadMode , 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, vea DiffGrams.
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento 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 contiene elementos sin espacio de nombres calificado. 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>
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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, XmlReadMode)
Lee el esquema XML y los datos en mediante DataSet el especificado TextReader y XmlReadMode.
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
desde el TextReader que se va a leer.
- mode
- XmlReadMode
Uno de los XmlReadMode valores.
Devoluciones
que XmlReadMode se usa para leer los datos.
Comentarios
El ReadXml método proporciona una manera de leer solo los datos, o tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento 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 contiene elementos sin espacio de nombres calificado. 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>
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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)
Lee el esquema XML y los datos en el DataSet utilizando 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 de archivo (incluida la ruta de acceso) desde el que se va a leer.
Devoluciones
que XmlReadMode se usa 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 DataSet esquema y los datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el ReadXml método se usa para rellenarlo con el esquema y los 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 tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento mientras se procesa.
Si el esquema XML de un DataSet elemento incluye , targetNamespacees 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 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>
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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)
Lee el esquema XML y los datos en mediante DataSet el especificado TextReader.
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
desde TextReader el que se va a leer el esquema y los datos.
Devoluciones
que XmlReadMode se usa para leer los datos.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El DataSet esquema y los datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el ReadXml método se usa para rellenarlo con el esquema y los 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 tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento 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 contiene elementos sin espacio de nombres calificado. 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 .
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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)
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
que XmlReadMode se usa para leer los datos.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El DataSet esquema y los datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el ReadXml método se usa para rellenarlo con el esquema y los 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 tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento 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 contiene elementos sin espacio de nombres calificado. 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>
Note
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 cuando se intenta leer el esquema en con DataSetReadXml 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)
- Usando conjuntos de datos en ADO.NET
Se aplica a
ReadXml(XmlReader)
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
que XmlReadMode se usa para leer los datos.
Ejemplos
En el ejemplo siguiente se crea primero un sencillo DataSet con una DataTable, dos columnas y diez filas. El DataSet esquema y los datos se escriben en el disco invocando el WriteXml método . Se crea un segundo DataSet y el ReadXml método se usa para rellenarlo con el esquema y los 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 tanto los datos como 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 ReadSchemaen .
Tenga en cuenta que lo mismo sucede con los WriteXml métodos y WriteXmlSchema , respectivamente. Para escribir datos XML, o tanto de esquema como de datos de DataSet, use el WriteXml método . Para escribir solo el esquema, use el WriteXmlSchema método .
Note
Se InvalidOperationException producirá una excepción si un tipo de columna en el DataRow que se lee o se escribe para implementar 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 tipos de datos diferentes), 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.
Note
DataSet No asocia un elemento XML a su correspondiente DataColumn o DataTable cuando se escapen caracteres XML legales como ("_") en el XML serializado. El DataSet propio solo escapa a caracteres XML no válidos en nombres de elementos XML y, por tanto, solo puede consumir lo mismo. Cuando se escapan los caracteres legales en el nombre del elemento XML, se omite el elemento mientras se procesa.
Si el esquema XML de un DataSet elemento incluye , targetNamespacees 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 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.
Note
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 cuando se intenta leer el esquema en con DataSetReadXml especificando XmlReadMode.ReadSchema. Esta excepción no se produce si usa .NET Framework versión 1.0.