DataSet.WriteXml Método
Definição
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 dados XML e, opcionalmente, o esquema do DataSet.
Sobrecargas
| Nome | Description |
|---|---|
| WriteXml(XmlWriter, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet uso do especificado XmlWriter e XmlWriteMode. Para gravar o esquema, defina o valor do |
| WriteXml(String, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet arquivo especificado usando o especificado XmlWriteMode. Para gravar o esquema, defina o valor do |
| WriteXml(TextWriter, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet uso do especificado TextWriter e XmlWriteMode. Para gravar o esquema, defina o valor do |
| WriteXml(Stream, XmlWriteMode) |
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet uso do especificado Stream e XmlWriteMode. Para gravar o esquema, defina o valor do |
| WriteXml(String) |
Grava os dados atuais para o DataSet arquivo especificado. |
| WriteXml(TextWriter) |
Grava os dados atuais para o DataSet uso do TextWriter. |
| WriteXml(XmlWriter) | |
| WriteXml(Stream) |
WriteXml(XmlWriter, XmlWriteMode)
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet uso do especificado XmlWriter e XmlWriteMode. Para gravar o esquema, defina o valor do mode parâmetro como WriteSchema.
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 XmlWriteMode valores.
Exemplos
O exemplo a seguir cria um System.IO.FileStream objeto que é usado para criar um novo XmlTextWriter. O XmlTextWriter objeto é usado com o WriteXml método para gravar um documento XML.
private void WriteXmlToFile(DataSet thisDataSet)
{
if (thisDataSet == null) { return; }
// Create a file name to write to.
string filename = "XmlDoc.xml";
// Create the FileStream to write with.
System.IO.FileStream stream = new System.IO.FileStream
(filename, System.IO.FileMode.Create);
// Create an XmlTextWriter with the fileStream.
System.Xml.XmlTextWriter xmlWriter =
new System.Xml.XmlTextWriter(stream,
System.Text.Encoding.Unicode);
// Write to the file with the WriteXml method.
thisDataSet.WriteXml(xmlWriter);
xmlWriter.Close();
}
Private Sub WriteXmlToFile(thisDataSet As DataSet)
If thisDataSet Is Nothing Then
Return
End If
' Create a file name to write to.
Dim filename As String = "XmlDoc.xml"
' Create the FileStream to write with.
Dim stream As New System.IO.FileStream _
(filename, System.IO.FileMode.Create)
' Create an XmlTextWriter with the fileStream.
Dim xmlWriter As New System.Xml.XmlTextWriter _
(stream, System.Text.Encoding.Unicode)
' Write to the file with the WriteXml method.
thisDataSet.WriteXml(xmlWriter)
xmlWriter.Close()
End Sub
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, defina o mode parâmetro como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(String, XmlWriteMode)
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet arquivo especificado usando o especificado XmlWriteMode. Para gravar o esquema, defina o valor do mode parâmetro 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 (incluindo o caminho) para o qual gravar.
- mode
- XmlWriteMode
Um dos XmlWriteMode valores.
Exceções
FileIOPermission não está definido como Write.
Exemplos
O exemplo a seguir usa o WriteXml método para gravar um documento XML.
private void WriteXmlToFile(DataSet thisDataSet)
{
if (thisDataSet == null) { return; }
// Create a file name to write to.
string filename = "XmlDoc.xml";
// Write to the file with the WriteXml method.
thisDataSet.WriteXml(filename);
}
Private Sub WriteXmlToFile(thisDataSet As DataSet)
If thisDataSet Is Nothing Then
Return
End If
' Create a file name to write to.
Dim filename As String = "XmlDoc.xml"
' Write to the file with the WriteXml method.
thisDataSet.WriteXml(filename)
End Sub
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, defina o mode parâmetro como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(TextWriter, XmlWriteMode)
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet uso do especificado TextWriter e XmlWriteMode. Para gravar o esquema, defina o valor do mode parâmetro como WriteSchema.
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
Um TextWriter objeto usado para gravar o documento.
- mode
- XmlWriteMode
Um dos XmlWriteMode valores.
Exemplos
O exemplo a seguir primeiro cria um simples DataSet com uma DataTable, duas colunas e dez linhas. O DataSet esquema e os dados são gravados em disco invocando o WriteXml método. Um segundo DataSet é criado e o ReadXml método é usado para preenchê-lo com esquema e dados.
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
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, defina o mode parâmetro como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(Stream, XmlWriteMode)
Grava os dados atuais e, opcionalmente, o esquema, para o DataSet uso do especificado Stream e XmlWriteMode. Para gravar o esquema, defina o valor do mode parâmetro como WriteSchema.
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
- mode
- XmlWriteMode
Um dos XmlWriteMode valores.
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, defina o mode parâmetro como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(String)
Grava os dados atuais para o DataSet 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 nome do arquivo (incluindo o caminho) para o qual gravar.
Exceções
FileIOPermission não está definido como Write.
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclui o mode parâmetro e defina seu valor como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(TextWriter)
Grava os dados atuais para o DataSet uso do TextWriter.
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 objeto com o qual gravar.
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclui o mode parâmetro e defina seu valor como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(XmlWriter)
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 WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclui o mode parâmetro e defina seu valor como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.
Confira também
Aplica-se a
WriteXml(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
Exemplos
O exemplo a seguir cria um System.IO.FileStream objeto. Em seguida, o objeto é usado com o WriteXml método para gravar um documento XML.
private void WriteXmlToFile(DataSet thisDataSet)
{
if (thisDataSet == null) { return; }
// Create a file name to write to.
string filename = "XmlDoc.xml";
// Create the FileStream to write with.
System.IO.FileStream stream = new System.IO.FileStream
(filename, System.IO.FileMode.Create);
// Write to the file with the WriteXml method.
thisDataSet.WriteXml(stream);
}
Private Sub WriteXmlToFile(thisDataSet As DataSet)
If thisDataSet Is Nothing Then
Return
End If
' Create a file name to write to.
Dim filename As String = "XmlDoc.xml"
' Create the FileStream to write with.
Dim stream As New System.IO.FileStream _
(filename, System.IO.FileMode.Create)
' Write to the file with the WriteXml method.
thisDataSet.WriteXml(stream)
End Sub
Comentários
O WriteXml método fornece uma maneira de gravar somente dados ou dados e esquema de um DataSet documento XML, enquanto o WriteXmlSchema método grava apenas o esquema. Para gravar dados e esquema, use uma das sobrecargas que inclui o mode parâmetro e defina seu valor como WriteSchema.
Observe que o mesmo é verdadeiro para os métodos e ReadXmlSchema os ReadXml métodos, respectivamente. Para ler dados XML ou esquema e dados no DataSetmétodo, use o ReadXml método. Para ler apenas o esquema, use o ReadXmlSchema método.
Note
Um InvalidOperationException será gerado se um tipo de coluna no DataRow que está sendo lido ou gravado para implementar IDynamicMetaObjectProvider e não implementar IXmlSerializable.