DataTable.WriteXml Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Grava o conteúdo atual do DataTable como XML.
WriteXml(TextWriter, Boolean) |
Grava o conteúdo atual do DataTable como XML usando o TextWriter especificado. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro |
WriteXml(TextWriter, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o TextWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(String, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema da DataTable usando o arquivo especificado e o XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(Stream, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema do DataTable no arquivo especificado usando o XmlWriteMode especificado. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(XmlWriter, Boolean) |
Grava o conteúdo atual do DataTable como XML usando o XmlWriter especificado. |
WriteXml(XmlWriter, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o XmlWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(Stream, XmlWriteMode, Boolean) |
Grava os dados atuais e, opcionalmente, o esquema do DataTable no arquivo especificado usando o XmlWriteMode especificado. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(TextWriter, XmlWriteMode, Boolean) |
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o TextWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(String, Boolean) |
Grava o conteúdo atual do DataTable como XML usando o arquivo especificado. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro |
WriteXml(Stream, Boolean) |
Grava o conteúdo atual do DataTable como XML usando o Stream especificado. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro |
WriteXml(XmlWriter, XmlWriteMode, Boolean) |
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o XmlWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(String) |
Grava o conteúdo atual do DataTable como XML usando o arquivo especificado. |
WriteXml(TextWriter) |
Grava o conteúdo atual do DataTable como XML usando o TextWriter especificado. |
WriteXml(Stream) |
Grava o conteúdo atual do DataTable como XML usando o Stream especificado. |
WriteXml(String, XmlWriteMode, Boolean) |
Grava os dados atuais e, opcionalmente, o esquema da DataTable usando o arquivo especificado e o XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro |
WriteXml(XmlWriter) |
Grava o conteúdo atual do DataTable como XML usando o XmlWriter especificado. |
O aplicativo de console a seguir cria duas DataTable instâncias, adiciona cada uma a um DataSet, cria uma DataRelation que relaciona as duas tabelas e, em seguida, usa o WriteXml método para gravar os dados contidos na tabela pai em um TextWriter. O exemplo demonstra o comportamento durante a definição do parâmetro writeHierarchy
como cada um de seus valores.
Nota
Este exemplo mostra como usar uma das versões sobrecarregadas do WriteXml. Para obter outros exemplos que possam estar disponíveis, consulte os tópicos de sobrecarga individuais.
static void Main()
{
DataSet ds = new DataSet();
DataTable customerTable = GetCustomers();
DataTable orderTable = GetOrders();
ds.Tables.Add(customerTable);
ds.Tables.Add(orderTable);
ds.Relations.Add("CustomerOrder",
new DataColumn[] { customerTable.Columns[0] },
new DataColumn[] { orderTable.Columns[1] }, true);
System.IO.StringWriter writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
PrintOutput(writer, "Customer table, without hierarchy");
writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
PrintOutput(writer, "Customer table, with hierarchy");
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static DataTable GetCustomers()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create two columns, ID and Name.
DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
table.Columns.Add("Name", typeof(System.String));
// Set the ID column as the primary key column.
table.PrimaryKey = new DataColumn[] { idColumn };
table.Rows.Add(new object[] { 1, "Mary" });
table.Rows.Add(new object[] { 2, "Andy" });
table.Rows.Add(new object[] { 3, "Peter" });
table.Rows.Add(new object[] { 4, "Russ" });
table.AcceptChanges();
return table;
}
private static DataTable GetOrders()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create three columns; OrderID, CustomerID, and OrderDate.
table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));
// Set the OrderID column as the primary key column.
table.PrimaryKey = new DataColumn[] { table.Columns[0] };
table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
table.AcceptChanges();
return table;
}
private static void PrintOutput(System.IO.TextWriter writer, string caption)
{
Console.WriteLine("==============================");
Console.WriteLine(caption);
Console.WriteLine("==============================");
Console.WriteLine(writer.ToString());
}
Sub Main()
Dim ds As New DataSet
Dim customerTable As DataTable = GetCustomers()
Dim orderTable As DataTable = GetOrders()
ds.Tables.Add(customerTable)
ds.Tables.Add(orderTable)
ds.Relations.Add("CustomerOrder", _
New DataColumn() {customerTable.Columns(0)}, _
New DataColumn() {orderTable.Columns(1)}, True)
Dim writer As New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
PrintOutput(writer, "Customer table, without hierarchy")
writer = New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
PrintOutput(writer, "Customer table, with hierarchy")
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Function GetOrders() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create three columns, OrderID, CustomerID, and OrderDate.
table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))
' Set the OrderID column as the primary key column.
table.PrimaryKey = New DataColumn() {table.Columns(0)}
table.Rows.Add(New Object() {1, 1, #12/2/2003#})
table.Rows.Add(New Object() {2, 1, #1/3/2004#})
table.Rows.Add(New Object() {3, 2, #11/13/2004#})
table.Rows.Add(New Object() {4, 3, #5/16/2004#})
table.Rows.Add(New Object() {5, 3, #5/22/2004#})
table.Rows.Add(New Object() {6, 4, #6/15/2004#})
table.AcceptChanges()
Return table
End Function
Private Function GetCustomers() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create two columns, ID and Name.
Dim idColumn As DataColumn = table.Columns.Add("ID", _
GetType(System.Int32))
table.Columns.Add("Name", GetType(System.String))
' Set the ID column as the primary key column.
table.PrimaryKey = New DataColumn() {idColumn}
table.Rows.Add(New Object() {1, "Mary"})
table.Rows.Add(New Object() {2, "Andy"})
table.Rows.Add(New Object() {3, "Peter"})
table.Rows.Add(New Object() {4, "Russ"})
table.AcceptChanges()
Return table
End Function
Private Sub PrintOutput( _
ByVal writer As System.IO.TextWriter, ByVal caption As String)
Console.WriteLine("==============================")
Console.WriteLine(caption)
Console.WriteLine("==============================")
Console.WriteLine(writer.ToString())
End Sub
O exemplo exibe a seguinte saída na janela do console:
==============================
Customer table, without hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
</NewDataSet>
==============================
Customer table, with hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Table2">
<xs:complexType>
<xs:sequence>
<xs:element name="OrderID" type="xs:int" />
<xs:element name="CustomerID" type="xs:int" minOccurs="0" />
<xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
<xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m
sdata:PrimaryKey="true">
<xs:selector xpath=".//Table2" />
<xs:field xpath="OrderID" />
</xs:unique>
<xs:keyref name="CustomerOrder" refer="Constraint1">
<xs:selector xpath=".//Table2" />
<xs:field xpath="CustomerID" />
</xs:keyref>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
<Table2>
<OrderID>1</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>2</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>3</OrderID>
<CustomerID>2</CustomerID>
<OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>4</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>5</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>6</OrderID>
<CustomerID>4</CustomerID>
<OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>
</Table2>
</NewDataSet>
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava o conteúdo atual do DataTable como XML usando o TextWriter especificado. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro writeHierarchy
como true
.
public:
void WriteXml(System::IO::TextWriter ^ writer, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter? writer, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter writer, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * bool -> unit
Public Sub WriteXml (writer As TextWriter, writeHierarchy As Boolean)
Parâmetros
- writer
- TextWriter
O TextWriter com o qual gravar o conteúdo.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Exemplos
O aplicativo de console a seguir cria duas DataTable instâncias, adiciona cada uma a um DataSet, cria uma DataRelation que relaciona as duas tabelas e, em seguida, usa o WriteXml método para gravar os dados contidos na tabela pai em um TextWriter. O exemplo demonstra o comportamento ao definir o writeHierarchy
parâmetro como true
.
static void Main()
{
DataSet ds = new DataSet();
DataTable customerTable = GetCustomers();
DataTable orderTable = GetOrders();
ds.Tables.Add(customerTable);
ds.Tables.Add(orderTable);
ds.Relations.Add("CustomerOrder",
new DataColumn[] { customerTable.Columns[0] },
new DataColumn[] { orderTable.Columns[1] }, true);
System.IO.StringWriter writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, true);
PrintOutput(writer, "Customer table, with hierarchy");
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static DataTable GetCustomers()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create two columns, ID and Name.
DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
table.Columns.Add("Name", typeof(System.String));
// Set the ID column as the primary key column.
table.PrimaryKey = new DataColumn[] { idColumn };
table.Rows.Add(new object[] { 1, "Mary" });
table.Rows.Add(new object[] { 2, "Andy" });
table.Rows.Add(new object[] { 3, "Peter" });
table.Rows.Add(new object[] { 4, "Russ" });
table.AcceptChanges();
return table;
}
private static DataTable GetOrders()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create three columns; OrderID, CustomerID, and OrderDate.
table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));
// Set the OrderID column as the primary key column.
table.PrimaryKey = new DataColumn[] { table.Columns[0] };
table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
table.AcceptChanges();
return table;
}
private static void PrintOutput(System.IO.TextWriter stream,
string caption)
{
Console.WriteLine("==============================");
Console.WriteLine(caption);
Console.WriteLine("==============================");
Console.WriteLine(stream.ToString());
}
Sub Main()
Dim ds As New DataSet
Dim customerTable As DataTable = GetCustomers()
Dim orderTable As DataTable = GetOrders()
ds.Tables.Add(customerTable)
ds.Tables.Add(orderTable)
ds.Relations.Add("CustomerOrder", _
New DataColumn() {customerTable.Columns(0)}, _
New DataColumn() {orderTable.Columns(1)}, True)
Dim writer As New System.IO.StringWriter
customerTable.WriteXml(writer, True)
PrintOutput(writer, "Customer table, with hierarchy")
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Function GetOrders() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create three columns, OrderID, CustomerID, and OrderDate.
table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))
' Set the OrderID column as the primary key column.
table.PrimaryKey = New DataColumn() {table.Columns(0)}
table.Rows.Add(New Object() {1, 1, #12/2/2003#})
table.Rows.Add(New Object() {2, 1, #1/3/2004#})
table.Rows.Add(New Object() {3, 2, #11/13/2004#})
table.Rows.Add(New Object() {4, 3, #5/16/2004#})
table.Rows.Add(New Object() {5, 3, #5/22/2004#})
table.Rows.Add(New Object() {6, 4, #6/15/2004#})
table.AcceptChanges()
Return table
End Function
Private Function GetCustomers() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create two columns, ID and Name.
Dim idColumn As DataColumn = table.Columns.Add("ID", _
GetType(System.Int32))
table.Columns.Add("Name", GetType(System.String))
' Set the ID column as the primary key column.
table.PrimaryKey = New DataColumn() {idColumn}
table.Rows.Add(New Object() {1, "Mary"})
table.Rows.Add(New Object() {2, "Andy"})
table.Rows.Add(New Object() {3, "Peter"})
table.Rows.Add(New Object() {4, "Russ"})
table.AcceptChanges()
Return table
End Function
Private Sub PrintOutput( _
ByVal stream As System.IO.TextWriter, ByVal caption As String)
Console.WriteLine("==============================")
Console.WriteLine(caption)
Console.WriteLine("==============================")
Console.WriteLine(stream.ToString())
End Sub
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados para a tabela atual e todas as tabelas relacionadas descendentes, chame o método com o writeHierarchy
parâmetro definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o TextWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
.
public:
void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml (System.IO.TextWriter? writer, System.Data.XmlWriteMode mode);
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode)
Parâmetros
- writer
- TextWriter
O TextWriter usado para gravar o documento.
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema da DataTable usando o arquivo especificado e o XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
.
public:
void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode);
public void WriteXml (string fileName, System.Data.XmlWriteMode mode);
member this.WriteXml : string * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode)
Parâmetros
- fileName
- String
O nome do arquivo no qual os dados serão gravados.
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema do DataTable no arquivo especificado usando o XmlWriteMode especificado. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
.
public:
void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode);
public void WriteXml (System.IO.Stream? stream, System.Data.XmlWriteMode mode);
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode)
Parâmetros
- stream
- Stream
O fluxo no qual os dados serão gravados.
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
public:
void WriteXml(System::Xml::XmlWriter ^ writer, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter? writer, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter writer, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * bool -> unit
Public Sub WriteXml (writer As XmlWriter, writeHierarchy As Boolean)
Parâmetros
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados para a tabela atual e suas tabelas relacionadas descendentes inteiras, chame o método com o writeHierarchy
parâmetro definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o XmlWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
.
public:
void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode);
public void WriteXml (System.Xml.XmlWriter? writer, System.Data.XmlWriteMode mode);
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode)
Parâmetros
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema do DataTable no arquivo especificado usando o XmlWriteMode especificado. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro writeHierarchy
como true
.
public:
void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.Stream? stream, System.Data.XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (stream As Stream, mode As XmlWriteMode, writeHierarchy As Boolean)
Parâmetros
- stream
- Stream
O fluxo no qual os dados serão gravados.
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable
a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode
e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o WriteXml
método salva dados somente para a tabela atual. O método WriteXml
fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable
a partir de um documento XML, e o método WriteXmlSchema
grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode
e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados da tabela atual e todos os descendentes, tabelas relacionadas, chame um método com o parâmetro writeHierarchy
definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o TextWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro writeHierarchy
como true
.
public:
void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter? writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode, writeHierarchy As Boolean)
Parâmetros
- writer
- TextWriter
O TextWriter usado para gravar o documento.
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Exemplos
O aplicativo de console a seguir cria duas DataTable instâncias, adiciona cada uma a um DataSet, cria uma DataRelation que relaciona as duas tabelas e, em seguida, usa o WriteXml método para gravar os dados contidos na tabela pai em um TextWriter. O exemplo demonstra o comportamento durante a definição do parâmetro writeHierarchy
como cada um de seus valores.
static void Main()
{
DataSet ds = new DataSet();
DataTable customerTable = GetCustomers();
DataTable orderTable = GetOrders();
ds.Tables.Add(customerTable);
ds.Tables.Add(orderTable);
ds.Relations.Add("CustomerOrder",
new DataColumn[] { customerTable.Columns[0] },
new DataColumn[] { orderTable.Columns[1] }, true);
System.IO.StringWriter writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, false);
PrintOutput(writer, "Customer table, without hierarchy");
writer = new System.IO.StringWriter();
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, true);
PrintOutput(writer, "Customer table, with hierarchy");
Console.WriteLine("Press any key to continue.");
Console.ReadKey();
}
private static DataTable GetCustomers()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create two columns, ID and Name.
DataColumn idColumn = table.Columns.Add("ID", typeof(System.Int32));
table.Columns.Add("Name", typeof(System.String));
// Set the ID column as the primary key column.
table.PrimaryKey = new DataColumn[] { idColumn };
table.Rows.Add(new object[] { 1, "Mary" });
table.Rows.Add(new object[] { 2, "Andy" });
table.Rows.Add(new object[] { 3, "Peter" });
table.Rows.Add(new object[] { 4, "Russ" });
table.AcceptChanges();
return table;
}
private static DataTable GetOrders()
{
// Create sample Customers table, in order
// to demonstrate the behavior of the DataTableReader.
DataTable table = new DataTable();
// Create three columns; OrderID, CustomerID, and OrderDate.
table.Columns.Add(new DataColumn("OrderID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("CustomerID", typeof(System.Int32)));
table.Columns.Add(new DataColumn("OrderDate", typeof(System.DateTime)));
// Set the OrderID column as the primary key column.
table.PrimaryKey = new DataColumn[] { table.Columns[0] };
table.Rows.Add(new object[] { 1, 1, "12/2/2003" });
table.Rows.Add(new object[] { 2, 1, "1/3/2004" });
table.Rows.Add(new object[] { 3, 2, "11/13/2004" });
table.Rows.Add(new object[] { 4, 3, "5/16/2004" });
table.Rows.Add(new object[] { 5, 3, "5/22/2004" });
table.Rows.Add(new object[] { 6, 4, "6/15/2004" });
table.AcceptChanges();
return table;
}
private static void PrintOutput(System.IO.TextWriter writer,
string caption)
{
Console.WriteLine("==============================");
Console.WriteLine(caption);
Console.WriteLine("==============================");
Console.WriteLine(writer.ToString());
}
Sub Main()
Dim ds As New DataSet
Dim customerTable As DataTable = GetCustomers()
Dim orderTable As DataTable = GetOrders()
ds.Tables.Add(customerTable)
ds.Tables.Add(orderTable)
ds.Relations.Add("CustomerOrder", _
New DataColumn() {customerTable.Columns(0)}, _
New DataColumn() {orderTable.Columns(1)}, True)
Dim writer As New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, False)
PrintOutput(writer, "Customer table, without hierarchy")
writer = New System.IO.StringWriter
customerTable.WriteXml(writer, XmlWriteMode.WriteSchema, True)
PrintOutput(writer, "Customer table, with hierarchy")
Console.WriteLine("Press any key to continue.")
Console.ReadKey()
End Sub
Private Function GetOrders() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create three columns, OrderID, CustomerID, and OrderDate.
table.Columns.Add(New DataColumn("OrderID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("CustomerID", GetType(System.Int32)))
table.Columns.Add(New DataColumn("OrderDate", GetType(System.DateTime)))
' Set the OrderID column as the primary key column.
table.PrimaryKey = New DataColumn() {table.Columns(0)}
table.Rows.Add(New Object() {1, 1, #12/2/2003#})
table.Rows.Add(New Object() {2, 1, #1/3/2004#})
table.Rows.Add(New Object() {3, 2, #11/13/2004#})
table.Rows.Add(New Object() {4, 3, #5/16/2004#})
table.Rows.Add(New Object() {5, 3, #5/22/2004#})
table.Rows.Add(New Object() {6, 4, #6/15/2004#})
table.AcceptChanges()
Return table
End Function
Private Function GetCustomers() As DataTable
' Create sample Customers table, in order
' to demonstrate the behavior of the DataTableReader.
Dim table As New DataTable
' Create two columns, ID and Name.
Dim idColumn As DataColumn = table.Columns.Add("ID", _
GetType(System.Int32))
table.Columns.Add("Name", GetType(System.String))
' Set the ID column as the primary key column.
table.PrimaryKey = New DataColumn() {idColumn}
table.Rows.Add(New Object() {1, "Mary"})
table.Rows.Add(New Object() {2, "Andy"})
table.Rows.Add(New Object() {3, "Peter"})
table.Rows.Add(New Object() {4, "Russ"})
table.AcceptChanges()
Return table
End Function
Private Sub PrintOutput( _
ByVal writer As System.IO.TextWriter, ByVal caption As String)
Console.WriteLine("==============================")
Console.WriteLine(caption)
Console.WriteLine("==============================")
Console.WriteLine(writer.ToString())
End Sub
O exemplo exibe a seguinte saída na janela do console:
==============================
Customer table, without hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
</NewDataSet>
==============================
Customer table, with hierarchy
==============================
<NewDataSet>
<xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema
" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:MainDataTable="Table1">
<xs:complexType>
<xs:choice minOccurs="0" maxOccurs="unbounded">
<xs:element name="Table1">
<xs:complexType>
<xs:sequence>
<xs:element name="ID" type="xs:int" />
<xs:element name="Name" type="xs:string" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Table2">
<xs:complexType>
<xs:sequence>
<xs:element name="OrderID" type="xs:int" />
<xs:element name="CustomerID" type="xs:int" minOccurs="0" />
<xs:element name="OrderDate" type="xs:dateTime" minOccurs="0" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
<xs:unique name="Constraint1" msdata:PrimaryKey="true">
<xs:selector xpath=".//Table1" />
<xs:field xpath="ID" />
</xs:unique>
<xs:unique name="Table2_Constraint1" msdata:ConstraintName="Constraint1" m
sdata:PrimaryKey="true">
<xs:selector xpath=".//Table2" />
<xs:field xpath="OrderID" />
</xs:unique>
<xs:keyref name="CustomerOrder" refer="Constraint1">
<xs:selector xpath=".//Table2" />
<xs:field xpath="CustomerID" />
</xs:keyref>
</xs:element>
</xs:schema>
<Table1>
<ID>1</ID>
<Name>Mary</Name>
</Table1>
<Table1>
<ID>2</ID>
<Name>Andy</Name>
</Table1>
<Table1>
<ID>3</ID>
<Name>Peter</Name>
</Table1>
<Table1>
<ID>4</ID>
<Name>Russ</Name>
</Table1>
<Table2>
<OrderID>1</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2003-12-02T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>2</OrderID>
<CustomerID>1</CustomerID>
<OrderDate>2004-01-03T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>3</OrderID>
<CustomerID>2</CustomerID>
<OrderDate>2004-11-13T00:00:00.0000000-08:00</OrderDate>
</Table2>
<Table2>
<OrderID>4</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-16T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>5</OrderID>
<CustomerID>3</CustomerID>
<OrderDate>2004-05-22T00:00:00.0000000-07:00</OrderDate>
</Table2>
<Table2>
<OrderID>6</OrderID>
<CustomerID>4</CustomerID>
<OrderDate>2004-06-15T00:00:00.0000000-07:00</OrderDate>
</Table2>
</NewDataSet>
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o WriteXml
método salva dados somente para a tabela atual. O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados da tabela atual e todos os descendentes, tabelas relacionadas, chame um método com o parâmetro writeHierarchy
definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava o conteúdo atual do DataTable como XML usando o arquivo especificado. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro writeHierarchy
como true
.
public:
void WriteXml(System::String ^ fileName, bool writeHierarchy);
public void WriteXml (string fileName, bool writeHierarchy);
member this.WriteXml : string * bool -> unit
Public Sub WriteXml (fileName As String, writeHierarchy As Boolean)
Parâmetros
- fileName
- String
O arquivo no qual gravar os dados XML.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados da tabela atual e todos os descendentes, tabelas relacionadas, chame um método com o parâmetro writeHierarchy
definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
public:
void WriteXml(System::IO::Stream ^ stream, bool writeHierarchy);
public void WriteXml (System.IO.Stream? stream, bool writeHierarchy);
public void WriteXml (System.IO.Stream stream, bool writeHierarchy);
member this.WriteXml : System.IO.Stream * bool -> unit
Public Sub WriteXml (stream As Stream, writeHierarchy As Boolean)
Parâmetros
- stream
- Stream
O fluxo no qual os dados serão gravados.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Comentários
Use o método WriteXmlSchema para gravar o esquema de um DataTable em um documento XML. O esquema inclui tabela, relação e definições de restrição.
O esquema XML é gravado usando o padrão XSD.
Para gravar os dados em um documento XML, use o método WriteXml.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados da tabela atual e todos os descendentes, tabelas relacionadas, chame um método com o parâmetro writeHierarchy
definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema do DataTable usando o XmlWriter e o XmlWriteMode especificados. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro writeHierarchy
como true
.
public:
void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter? writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode, writeHierarchy As Boolean)
Parâmetros
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados para a tabela atual e suas tabelas relacionadas descendentes inteiras, chame o método com o writeHierarchy
parâmetro definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava o conteúdo atual do DataTable como XML usando o arquivo especificado.
public:
void WriteXml(System::String ^ fileName);
public void WriteXml (string fileName);
member this.WriteXml : string -> unit
Public Sub WriteXml (fileName As String)
Parâmetros
- fileName
- String
O arquivo no qual gravar os dados XML.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava o conteúdo atual do DataTable como XML usando o TextWriter especificado.
public:
void WriteXml(System::IO::TextWriter ^ writer);
public void WriteXml (System.IO.TextWriter? writer);
public void WriteXml (System.IO.TextWriter writer);
member this.WriteXml : System.IO.TextWriter -> unit
Public Sub WriteXml (writer As TextWriter)
Parâmetros
- writer
- TextWriter
O TextWriter com o qual gravar o conteúdo.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
public:
void WriteXml(System::IO::Stream ^ stream);
public void WriteXml (System.IO.Stream? stream);
public void WriteXml (System.IO.Stream stream);
member this.WriteXml : System.IO.Stream -> unit
Public Sub WriteXml (stream As Stream)
Parâmetros
- stream
- Stream
O fluxo no qual os dados serão gravados.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclua o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
Grava os dados atuais e, opcionalmente, o esquema da DataTable usando o arquivo especificado e o XmlWriteMode. Para gravar o esquema, defina o valor do parâmetro mode
como WriteSchema
. Para salvar os dados para a tabela e todos os descendentes, defina o parâmetro writeHierarchy
como true
.
public:
void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode, bool writeHierarchy);
public void WriteXml (string fileName, System.Data.XmlWriteMode mode, bool writeHierarchy);
member this.WriteXml : string * System.Data.XmlWriteMode * bool -> unit
Public Sub WriteXml (fileName As String, mode As XmlWriteMode, writeHierarchy As Boolean)
Parâmetros
- fileName
- String
O nome do arquivo no qual os dados serão gravados.
- mode
- XmlWriteMode
Um dos valores de XmlWriteMode.
- writeHierarchy
- Boolean
Se for true
, grave o conteúdo da tabela atual e todos os descendentes. Se false
(o valor padrão), grave apenas os dados da tabela atual.
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o WriteXml
método salva dados somente para a tabela atual. Se você quiser salvar os dados da tabela atual e de todo o esquema, o WriteXml método fornecerá uma maneira de gravar somente dados ou dados e esquemas de um em um DataTable documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Normalmente, o método WriteXml
grava os dados somente para a tabela atual. Para gravar os dados para a tabela atual e todas as tabelas relacionadas descendentes, chame o método com o writeHierarchy
parâmetro definido como true
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
- Origem:
- DataTable.cs
public:
void WriteXml(System::Xml::XmlWriter ^ writer);
public void WriteXml (System.Xml.XmlWriter? writer);
public void WriteXml (System.Xml.XmlWriter writer);
member this.WriteXml : System.Xml.XmlWriter -> unit
Public Sub WriteXml (writer As XmlWriter)
Parâmetros
Comentários
O método WriteXml fornece uma maneira de gravar apenas dados ou dados e esquema em um DataTable a partir de um documento XML, e o método WriteXmlSchema grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que incluam o parâmetro XmlWriteMode e defina o valor como WriteSchema
.
Observe que o mesmo é verdadeiro para os métodos ReadXml e ReadXmlSchema, respectivamente. Para ler dados XML, ou o esquema e os dados no DataTable
, use o método ReadXml
. Para ler apenas o esquema, use o método ReadXmlSchema
.
Nota
Um InvalidOperationException será lançado se um tipo de coluna no DataRow
de leitura ou gravação implementa IDynamicMetaObjectProvider e não implementa IXmlSerializable.
Confira também
Aplica-se a
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: