DataTable.ReadXml Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê o esquema XML e os dados no DataTablearquivo .
Sobrecargas
| Name | Description |
|---|---|
| ReadXml(Stream) |
Lê o esquema XML e os dados no DataTable usando o especificado Stream. |
| ReadXml(TextReader) |
Lê o esquema XML e os dados no DataTable usando o especificado TextReader. |
| ReadXml(String) |
Lê o esquema XML e os dados do DataTable ficheiro especificado. |
| ReadXml(XmlReader) |
Lê o Esquema XML e os Dados no DataTable usando o especificado XmlReader. |
Observações
O ReadXml método permite ler apenas dados, ou ambos os dados e o esquema, a DataTable partir de um documento XML, enquanto o ReadXmlSchema método lê apenas o esquema. Para ler tanto os dados como o esquema, use uma das ReadXML sobrecargas que inclui o XmlReadMode parâmetro e defina o seu valor para ReadSchema.
Note-se que o mesmo se aplica aos WriteXml métodos e, WriteXmlSchema respetivamente. Para escrever dados XML, ou tanto o esquema como os dados do DataTable, use o WriteXml método. Para escrever apenas o esquema, use o WriteXmlSchema método.
Note
Um InvalidOperationException será lançado se um tipo de coluna em DataRow o que está a ser lido ou escrito em implementa IDynamicMetaObjectProvider e não implementar IXmlSerializable.
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
Devoluções
Eles XmlReadMode foram usados para ler os dados.
Exemplos
O exemplo seguinte cria um DataTable contendo duas colunas e dez linhas. O exemplo escreve o DataTable esquema e os dados num fluxo de memória, invocando o WriteXml método. O exemplo cria um segundo DataTable e chama o ReadXml método para o preencher com esquema e dados.
private static void DemonstrateReadWriteXMLDocumentWithStream()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
// Write the schema and data to XML in a memory stream.
System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);
// Rewind the memory stream.
xmlStream.Position = 0;
DataTable newTable = new DataTable();
newTable.ReadXml(xmlStream);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
// Display the contents of the supplied DataTable:
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithStream()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a memory stream.
Dim xmlStream As New System.IO.MemoryStream()
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)
' Rewind the memory stream.
xmlStream.Position = 0
Dim newTable As New DataTable
newTable.ReadXml(xmlStream)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, ByVal label As String)
' Display the contents of the supplied DataTable:
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Observações
A corrente DataTable e os seus descendentes são carregados com os dados fornecidos Streampor . O comportamento deste método é idêntico ao DataSet.ReadXml do método, exceto que, neste caso, os dados são carregados apenas para a tabela atual e os seus descendentes.
O ReadXml método permite ler apenas dados, ou ambos os dados e o esquema, a DataTable partir de um documento XML, enquanto o ReadXmlSchema método lê apenas o esquema.
Note-se que o mesmo se aplica aos WriteXml métodos e, WriteXmlSchema respetivamente. Para escrever dados XML, ou tanto o esquema como os dados do DataTable, use o WriteXml método. Para escrever apenas o esquema, use o WriteXmlSchema método.
Note
Um InvalidOperationException será lançado se um tipo de coluna em DataRow o que está a ser lido ou escrito em implementa IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Se for especificado um esquema em linha, o esquema em linha é usado para estender a estrutura relacional existente antes de carregar os dados. Se houver conflitos (por exemplo, a mesma coluna na mesma tabela definida com tipos de dados diferentes), é criada uma exceção.
Se não for especificado um esquema em linha, a estrutura relacional é estendida por inferência, conforme necessário, de acordo com a estrutura do documento XML. Se o esquema não puder ser estendido por inferência para expor todos os dados, é levantada uma exceção.
Note
O DataSet não associa um elemento XML ao seu correspondente DataColumn ou DataTable quando caracteres XML legais como ("_") são escapados no XML serializado. O DataSet próprio só escapa a caracteres XML ilegais nos nomes dos elementos XML e, por isso, só pode consumir os mesmos. Quando caracteres legais no nome de um elemento XML são escapados, o elemento é ignorado durante o processamento.
Ver também
Aplica-se a
ReadXml(TextReader)
Lê o esquema XML e os dados no DataTable usando o 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
Isso TextReader será usado para ler os dados.
Devoluções
Eles XmlReadMode foram usados para ler os dados.
Exemplos
O exemplo seguinte cria um DataTable contendo duas colunas e dez linhas. O exemplo escreve o DataTable esquema e os dados num fluxo de memória, invocando o WriteXml método. O exemplo cria um segundo DataTable e chama o ReadXml método para o preencher com esquema e dados.
private static void DemonstrateReadWriteXMLDocumentWithReader()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
// Write the schema and data to XML in a memory stream.
System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);
// Rewind the memory stream.
xmlStream.Position = 0;
System.IO.StreamReader reader =
new System.IO.StreamReader(xmlStream);
DataTable newTable = new DataTable();
newTable.ReadXml(reader);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a memory stream.
Dim xmlStream As New System.IO.MemoryStream()
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)
' Rewind the memory stream.
xmlStream.Position = 0
Dim reader As New System.IO.StreamReader(xmlStream)
Dim newTable As New DataTable
newTable.ReadXml(reader)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) _
As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, _
ByVal label As String)
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Observações
A corrente DataTable e os seus descendentes são carregados com os dados fornecidos TextReaderpor . O comportamento deste método é idêntico ao DataSet.ReadXml do método, exceto que, neste caso, os dados são carregados apenas para a tabela atual e os seus descendentes.
O ReadXml método permite ler apenas dados, ou ambos os dados e o esquema, a DataTable partir de um documento XML, enquanto o ReadXmlSchema método lê apenas o esquema.
Note-se que o mesmo se aplica aos WriteXml métodos e, WriteXmlSchema respetivamente. Para escrever dados XML, ou tanto o esquema como os dados do DataTable, use o WriteXml método. Para escrever apenas o esquema, use o WriteXmlSchema método.
Note
Um InvalidOperationException será lançado se um tipo de coluna em DataRow o que está a ser lido ou escrito em implementa IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Se for especificado um esquema em linha, o esquema em linha é usado para estender a estrutura relacional existente antes de carregar os dados. Se houver conflitos (por exemplo, a mesma coluna na mesma tabela definida com tipos de dados diferentes), é criada uma exceção.
Se não for especificado um esquema em linha, a estrutura relacional é estendida por inferência, conforme necessário, de acordo com a estrutura do documento XML. Se o esquema não puder ser estendido por inferência para expor todos os dados, é levantada uma exceção.
Note
O DataSet não associa um elemento XML ao seu correspondente DataColumn ou DataTable quando caracteres XML legais como ("_") são escapados no XML serializado. O DataSet próprio só escapa a caracteres XML ilegais nos nomes dos elementos XML e, por isso, só pode consumir os mesmos. Quando caracteres legais no nome de um elemento XML são escapados, o elemento é ignorado durante o processamento.
Ver também
Aplica-se a
ReadXml(String)
Lê o esquema XML e os dados do DataTable ficheiro 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
O nome do ficheiro a partir do qual ler os dados.
Devoluções
Eles XmlReadMode foram usados para ler os dados.
Exemplos
O exemplo seguinte cria um DataTable contendo duas colunas e dez linhas. O exemplo grava o DataTable esquema e os dados no disco. O exemplo cria um segundo DataTable e chama o ReadXml método para o preencher com esquema e dados.
private static void DemonstrateReadWriteXMLDocumentWithString()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
string fileName = "C:\\TestData.xml";
table.WriteXml(fileName, XmlWriteMode.WriteSchema);
DataTable newTable = new DataTable();
newTable.ReadXml(fileName);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithString()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a file.
Dim fileName As String = "C:\TestData.xml"
table.WriteXml(fileName, XmlWriteMode.WriteSchema)
Dim newTable As New DataTable
newTable.ReadXml(fileName)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) _
As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, _
ByVal label As String)
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Observações
A corrente DataTable e os seus descendentes são carregados com os dados do ficheiro nomeado no arquivo fornecido String. O comportamento deste método é idêntico ao DataSet.ReadXml do método, exceto que, neste caso, os dados são carregados apenas para a tabela atual e os seus descendentes.
O ReadXml método permite ler apenas dados, ou ambos os dados e o esquema, a DataTable partir de um documento XML, enquanto o ReadXmlSchema método lê apenas o esquema.
Note-se que o mesmo se aplica aos WriteXml métodos e, WriteXmlSchema respetivamente. Para escrever dados XML, ou tanto o esquema como os dados do DataTable, use o WriteXml método. Para escrever apenas o esquema, use o WriteXmlSchema método.
Note
Um InvalidOperationException será lançado se um tipo de coluna em DataRow o que está a ser lido ou escrito em implementa IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Se for especificado um esquema em linha, o esquema em linha é usado para estender a estrutura relacional existente antes de carregar os dados. Se houver conflitos (por exemplo, a mesma coluna na mesma tabela definida com tipos de dados diferentes), é criada uma exceção.
Se não for especificado um esquema em linha, a estrutura relacional é estendida por inferência, conforme necessário, de acordo com a estrutura do documento XML. Se o esquema não puder ser estendido por inferência para expor todos os dados, é levantada uma exceção.
Note
O DataSet não associa um elemento XML ao seu correspondente DataColumn ou DataTable quando caracteres XML legais como ("_") são escapados no XML serializado. O DataSet próprio só escapa a caracteres XML ilegais nos nomes dos elementos XML e, por isso, só pode consumir os mesmos. Quando caracteres legais no nome de um elemento XML são escapados, o elemento é ignorado durante o processamento.
using System.Data;
public class A {
static void Main(string[] args) {
DataTable tabl = new DataTable("mytable");
tabl.Columns.Add(new DataColumn("id", typeof(int)));
for (int i = 0; i < 10; i++) {
DataRow row = tabl.NewRow();
row["id"] = i;
tabl.Rows.Add(row);
}
tabl.WriteXml("f.xml", XmlWriteMode.WriteSchema);
DataTable newt = new DataTable();
newt.ReadXml("f.xml");
}
}
Ver também
Aplica-se 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
Devoluções
Eles XmlReadMode foram usados para ler os dados.
Exemplos
O exemplo seguinte cria um DataTable contendo duas colunas e dez linhas. O exemplo escreve o DataTable esquema e os dados num XmlReader. O exemplo cria um segundo DataTable e chama o ReadXml método para o preencher com o esquema e os dados da XmlReader instância.
private static void DemonstrateReadWriteXMLDocumentWithReader()
{
DataTable table = CreateTestTable("XmlDemo");
PrintValues(table, "Original table");
// Write the schema and data to XML in a memory stream.
System.IO.MemoryStream xmlStream = new System.IO.MemoryStream();
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema);
// Rewind the memory stream.
xmlStream.Position = 0;
System.Xml.XmlTextReader reader =
new System.Xml.XmlTextReader(xmlStream);
DataTable newTable = new DataTable();
newTable.ReadXml(reader);
// Print out values in the table.
PrintValues(newTable, "New table");
}
private static DataTable CreateTestTable(string tableName)
{
// Create a test DataTable with two columns and a few rows.
DataTable table = new DataTable(tableName);
DataColumn column = new DataColumn("id", typeof(System.Int32));
column.AutoIncrement = true;
table.Columns.Add(column);
column = new DataColumn("item", typeof(System.String));
table.Columns.Add(column);
// Add ten rows.
DataRow row;
for (int i = 0; i <= 9; i++)
{
row = table.NewRow();
row["item"] = "item " + i;
table.Rows.Add(row);
}
table.AcceptChanges();
return table;
}
private static void PrintValues(DataTable table, string label)
{
Console.WriteLine(label);
foreach (DataRow row in table.Rows)
{
foreach (DataColumn column in table.Columns)
{
Console.Write("\t{0}", row[column]);
}
Console.WriteLine();
}
}
Private Sub DemonstrateReadWriteXMLDocumentWithReader()
Dim table As DataTable = CreateTestTable("XmlDemo")
PrintValues(table, "Original table")
' Write the schema and data to XML in a memory stream.
Dim xmlStream As New System.IO.MemoryStream()
table.WriteXml(xmlStream, XmlWriteMode.WriteSchema)
' Rewind the memory stream.
xmlStream.Position = 0
Dim reader As New System.Xml.XmlTextReader(xmlStream)
Dim newTable As New DataTable
newTable.ReadXml(reader)
' Print out values in the table.
PrintValues(newTable, "New Table")
End Sub
Private Function CreateTestTable(ByVal tableName As String) _
As DataTable
' Create a test DataTable with two columns and a few rows.
Dim table As New DataTable(tableName)
Dim column As New DataColumn("id", GetType(System.Int32))
column.AutoIncrement = True
table.Columns.Add(column)
column = New DataColumn("item", GetType(System.String))
table.Columns.Add(column)
' Add ten rows.
Dim row As DataRow
For i As Integer = 0 To 9
row = table.NewRow()
row("item") = "item " & i
table.Rows.Add(row)
Next i
table.AcceptChanges()
Return table
End Function
Private Sub PrintValues(ByVal table As DataTable, _
ByVal label As String)
Console.WriteLine(label)
For Each row As DataRow In table.Rows
For Each column As DataColumn In table.Columns
Console.Write("{0}{1}", ControlChars.Tab, row(column))
Next column
Console.WriteLine()
Next row
End Sub
Observações
A corrente DataTable e os seus descendentes são carregados com os dados do ficheiro nomeado no arquivo fornecido XmlReader. O comportamento deste método é idêntico ao ReadXml do método, exceto que, neste caso, os dados são carregados apenas para a tabela atual e os seus descendentes.
O ReadXml método permite ler apenas dados, ou ambos os dados e o esquema, a DataTable partir de um documento XML, enquanto o ReadXmlSchema método lê apenas o esquema.
Note-se que o mesmo se aplica aos WriteXml métodos e, WriteXmlSchema respetivamente. Para escrever dados XML, ou tanto o esquema como os dados do DataTable, use o WriteXml método. Para escrever apenas o esquema, use o WriteXmlSchema método.
Note
Um InvalidOperationException será lançado se um tipo de coluna em DataRow o que está a ser lido ou escrito em implementa IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Se for especificado um esquema em linha, o esquema em linha é usado para estender a estrutura relacional existente antes de carregar os dados. Se houver conflitos (por exemplo, a mesma coluna na mesma tabela definida com tipos de dados diferentes), é criada uma exceção.
Se não for especificado um esquema em linha, a estrutura relacional é estendida por inferência, conforme necessário, de acordo com a estrutura do documento XML. Se o esquema não puder ser estendido por inferência para expor todos os dados, é levantada uma exceção.
Note
O DataSet não associa um elemento XML ao seu correspondente DataColumn ou DataTable quando caracteres XML legais como ("_") são escapados no XML serializado. O DataSet próprio só escapa a caracteres XML ilegais nos nomes dos elementos XML e, por isso, só pode consumir os mesmos. Quando caracteres legais no nome de um elemento XML são escapados, o elemento é ignorado durante o processamento.