DataSet.WriteXml メソッド

定義

DataSetから XML データと必要に応じてスキーマを書き込みます。

オーバーロード

WriteXml(XmlWriter, XmlWriteMode)

指定した XmlWriterXmlWriteModeを使用して、DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を WriteSchemaに設定します。

WriteXml(String, XmlWriteMode)

指定した XmlWriteModeを使用して、指定したファイルに DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を WriteSchemaに設定します。

WriteXml(TextWriter, XmlWriteMode)

指定した TextWriterXmlWriteModeを使用して、DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を WriteSchemaに設定します。

WriteXml(Stream, XmlWriteMode)

指定した StreamXmlWriteModeを使用して、DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を WriteSchemaに設定します。

WriteXml(String)

指定したファイルに DataSet の現在のデータを書き込みます。

WriteXml(TextWriter)

指定した TextWriterを使用して、DataSet の現在のデータを書き込みます。

WriteXml(XmlWriter)

指定した XmlWriterDataSet の現在のデータを書き込みます。

WriteXml(Stream)

指定した Streamを使用して、DataSet の現在のデータを書き込みます。

WriteXml(XmlWriter, XmlWriteMode)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した XmlWriterXmlWriteModeを使用して、DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を 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)

パラメーター

writer
XmlWriter

書き込む XmlWriter

mode
XmlWriteMode

XmlWriteMode 値の 1 つ。

次の例では、新しい XmlTextWriterの作成に使用する System.IO.FileStream オブジェクトを作成します。 XmlTextWriter オブジェクトは、XML ドキュメントを記述するために、WriteXml メソッドと共に使用されます。

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

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(String, XmlWriteMode)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した XmlWriteModeを使用して、指定したファイルに DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を 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)

パラメーター

fileName
String

書き込むファイル名 (パスを含む)。

mode
XmlWriteMode

XmlWriteMode 値の 1 つ。

例外

FileIOPermissionWriteに設定されていません。

次の例では、WriteXml メソッドを使用して 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

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(TextWriter, XmlWriteMode)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した TextWriterXmlWriteModeを使用して、DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を 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)

パラメーター

writer
TextWriter

ドキュメントの書き込みに使用する TextWriter オブジェクト。

mode
XmlWriteMode

XmlWriteMode 値の 1 つ。

次の例では、最初に、1 つの DataTable、2 つの列、10 行の単純な DataSet を作成します。 DataSet スキーマとデータは、WriteXml メソッドを呼び出すことによってディスクに書き込まれます。 2 つ目の DataSet が作成され、ReadXml メソッドを使用してスキーマとデータを入力します。

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

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(Stream, XmlWriteMode)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した StreamXmlWriteModeを使用して、DataSet の現在のデータと必要に応じてスキーマを書き込みます。 スキーマを書き込むには、mode パラメーターの値を 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)

パラメーター

stream
Stream

ファイルへの書き込みに使用する Stream オブジェクト。

mode
XmlWriteMode

XmlWriteMode 値の 1 つ。

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(String)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定したファイルに DataSet の現在のデータを書き込みます。

public:
 void WriteXml(System::String ^ fileName);
public void WriteXml (string fileName);
member this.WriteXml : string -> unit
Public Sub WriteXml (fileName As String)

パラメーター

fileName
String

書き込むファイル名 (パスを含む)。

例外

FileIOPermissionWriteに設定されていません。

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを含むいずれかのオーバーロードを使用し、その値を WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(TextWriter)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した TextWriterを使用して、DataSet の現在のデータを書き込みます。

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)

パラメーター

writer
TextWriter

書き込む TextWriter オブジェクト。

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを含むいずれかのオーバーロードを使用し、その値を WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(XmlWriter)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した XmlWriterDataSet の現在のデータを書き込みます。

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)

パラメーター

writer
XmlWriter

書き込む XmlWriter

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを含むいずれかのオーバーロードを使用し、その値を WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象

WriteXml(Stream)

ソース:
DataSet.cs
ソース:
DataSet.cs
ソース:
DataSet.cs

指定した Streamを使用して、DataSet の現在のデータを書き込みます。

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)

パラメーター

stream
Stream

ファイルへの書き込みに使用する Stream オブジェクト。

次の例では、System.IO.FileStream オブジェクトを作成します。 その後、オブジェクトを WriteXml メソッドと共に使用して、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

注釈

WriteXml メソッドは、データのみ、または DataSet のデータとスキーマの両方を XML ドキュメントに書き込む方法を提供しますが、WriteXmlSchema メソッドはスキーマのみを書き込みます。 データとスキーマの両方を書き込むには、mode パラメーターを含むいずれかのオーバーロードを使用し、その値を WriteSchemaに設定します。

ReadXml メソッドと ReadXmlSchema メソッドについても、それぞれ同じことが当てはまります。 XML データ、またはスキーマとデータの両方を DataSetに読み取る場合は、ReadXml メソッドを使用します。 スキーマのみを読み取る場合は、ReadXmlSchema メソッドを使用します。

手記

IDynamicMetaObjectProvider を実装するために読み取りまたは書き込みを行う DataRow 内の列型が IXmlSerializableを実装していない場合、InvalidOperationException がスローされます。

こちらもご覧ください

  • ADO.NETでのデータセットの使用の

適用対象