DataSet.WriteXml メソッド (String, XmlWriteMode)

指定した XmlWriteMode を使用して、 DataSet の現在のデータを、指定したファイルに書き込みます。オプションでスキーマを書き込むこともできます。スキーマを書き込むには、 XMLWriteMode パラメータの値を WriteSchema に設定します。

Overloads Public Sub WriteXml( _
   ByVal fileName As String, _   ByVal mode As XmlWriteMode _)
[C#]
public void WriteXml(stringfileName,XmlWriteModemode);
[C++]
public: void WriteXml(String* fileName,XmlWriteModemode);
[JScript]
public function WriteXml(
   fileName : String,mode : XmlWriteMode);

パラメータ

• fileName
  書き込み先の (パスを含む) ファイル名。
• mode
  XmlWriteMode 値の 1 つ。

例外

解説

WriteXml メソッドを使用すると、 DataSet から XML ドキュメントに、データだけ、またはデータとスキーマの両方を書き込むことができます。これに対して、 WriteXmlSchema メソッドは、スキーマだけを書き込みます。データとスキーマの両方を書き込むには、 WriteXmlMode パラメータを WriteSchema に設定します。

それぞれ ReadXml メソッドと ReadXmlSchema メソッドでも同様です。XML データ、またはスキーマとデータの両方を DataSet に読み込むには、 ReadXml メソッドを使用します。スキーマだけを読み込むには、 ReadXmlSchema メソッドを使用します。

使用例

[Visual Basic, C#, C++] WriteXml メソッドを使用して XML ドキュメントを書き込む例を次に示します。

 
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 = "myXmlDoc.xml"
    ' Write to the file with the WriteXml method.
    thisDataSet.WriteXml(filename)
End Sub

[C#] 
private void WriteXmlToFile(DataSet thisDataSet) {
   if (thisDataSet == null) { return; }
   // Create a file name to write to.
   string filename = "myXmlDoc.xml";
   // Write to the file with the WriteXml method.
   thisDataSet.WriteXml(filename);
}

[C++] 
private:
 void WriteXmlToFile(DataSet* thisDataSet) {
    if (thisDataSet == 0) { return; }
    // Create a file name to write to.
    String* filename = S"myXmlDoc.xml";
    // Write to the file with the WriteXml method.
    thisDataSet->WriteXml(filename);
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• FileIOPermission (ファイルの読み書き用) FileIOPermissionAccess (関連する列挙体)

参照

DataSet クラス | DataSet メンバ | System.Data 名前空間 | DataSet.WriteXml オーバーロードの一覧 | ReadXml | ReadXmlSchema | WriteXml | WriteXmlSchema