Share via

DataTable.WriteXml Metode

  • Referensi

Definisi

Ruang nama:
System.Data
Rakitan:
System.Data.Common.dll
Rakitan:
System.Data.dll
Rakitan:
netstandard.dll

Menulis isi DataTable saat ini sebagai XML.

Overload

WriteXml(TextWriter, Boolean)

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan TextWriter. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(TextWriter, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(String, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan file yang ditentukan dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(Stream, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataTable ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(XmlWriter, Boolean)

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan XmlWriter.
WriteXml(XmlWriter, XmlWriteMode)

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(Stream, XmlWriteMode, Boolean)

Menulis data saat ini, dan secara opsional skema, untuk DataTable ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(TextWriter, XmlWriteMode, Boolean)

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(String, Boolean)

Menulis konten saat ini sebagai DataTable XML menggunakan file yang ditentukan. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(Stream, Boolean)

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan Stream. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(XmlWriter, XmlWriteMode, Boolean)

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(String)

Menulis konten saat ini sebagai DataTable XML menggunakan file yang ditentukan.
WriteXml(TextWriter)

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan TextWriter.
WriteXml(Stream)

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan Stream.
WriteXml(String, XmlWriteMode, Boolean)

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan file yang ditentukan dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.
WriteXml(XmlWriter)

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan XmlWriter.

Contoh

Aplikasi konsol berikut membuat dua DataTable instans, menambahkan masing-masing ke DataSet, membuat yang DataRelation berkaitan dengan dua tabel, lalu menggunakan WriteXml metode untuk menulis data yang terkandung dalam tabel induk ke TextWriter. Contoh menunjukkan perilaku saat mengatur writeHierarchy parameter ke setiap nilainya.

Catatan

Contoh ini menunjukkan cara menggunakan salah satu versi WriteXml yang kelebihan beban. Untuk contoh lain yang mungkin tersedia, lihat topik kelebihan beban individual.

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

Contoh ini menampilkan output berikut di jendela konsol:

==============================
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>

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

WriteXml(TextWriter, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan TextWriter. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

writer
TextWriter

yang TextWriter digunakan untuk menulis konten.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Contoh

Aplikasi konsol berikut membuat dua DataTable instans, menambahkan masing-masing ke DataSet, membuat yang DataRelation berkaitan dengan dua tabel, lalu menggunakan WriteXml metode untuk menulis data yang terkandung dalam tabel induk ke TextWriter. Contoh menunjukkan perilaku saat mengatur parameter ke writeHierarchytrue.

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

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan semua turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(TextWriter, XmlWriteMode)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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)

Parameter

writer
TextWriter

yang TextWriter digunakan untuk menulis dokumen.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(String, XmlWriteMode)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan file yang ditentukan dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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)

Parameter

fileName
String

Nama file tempat data akan ditulis.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(Stream, XmlWriteMode)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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)

Parameter

stream
Stream

Aliran tempat data akan ditulis.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(XmlWriter, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan XmlWriter.

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)

Parameter

writer
XmlWriter

yang XmlWriter digunakan untuk menulis konten.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan seluruh turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(XmlWriter, XmlWriteMode)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.

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)

Parameter

writer
XmlWriter

yang XmlWriter digunakan untuk menulis dokumen.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(Stream, XmlWriteMode, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

stream
Stream

Aliran tempat data akan ditulis.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Biasanya, WriteXml metode menyimpan data hanya untuk tabel saat ini. Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan semua turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(TextWriter, XmlWriteMode, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

writer
TextWriter

yang TextWriter digunakan untuk menulis dokumen.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Contoh

Aplikasi konsol berikut membuat dua DataTable instans, menambahkan masing-masing ke DataSet, membuat yang DataRelation berkaitan dengan dua tabel, lalu menggunakan WriteXml metode untuk menulis data yang terkandung dalam tabel induk ke TextWriter. Contoh menunjukkan perilaku saat mengatur writeHierarchy parameter ke setiap nilainya.

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

Contoh ini menampilkan output berikut di jendela konsol:

==============================
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>

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Biasanya, WriteXml metode menyimpan data hanya untuk tabel saat ini. Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan semua turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(String, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan file yang ditentukan. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

fileName
String

File untuk menulis data XML.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan semua turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(Stream, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan Stream. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

stream
Stream

Aliran tempat data akan ditulis.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Keterangan

WriteXmlSchema Gunakan metode untuk menulis skema untuk DataTable dokumen XML. Skema ini mencakup definisi tabel, hubungan, dan batasan.

Skema XML ditulis menggunakan standar XSD.

Untuk menulis data ke dokumen XML, gunakan WriteXml metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan semua turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

writer
XmlWriter

yang XmlWriter digunakan untuk menulis dokumen.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan seluruh turunannya, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(String)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan file yang ditentukan.

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

Parameter

fileName
String

File untuk menulis data XML.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(TextWriter)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan TextWriter.

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)

Parameter

writer
TextWriter

yang TextWriter digunakan untuk menulis konten.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(Stream)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan Stream.

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)

Parameter

stream
Stream

Aliran tempat data akan ditulis.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(String, XmlWriteMode, Boolean)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis data saat ini, dan secara opsional skema, untuk DataTable menggunakan file yang ditentukan dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema. Untuk menyimpan data untuk tabel dan semua turunannya, atur parameter ke writeHierarchytrue.

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)

Parameter

fileName
String

Nama file tempat data akan ditulis.

mode
XmlWriteMode

Salah XmlWriteMode satu nilai.

writeHierarchy
Boolean

Jika true, tulis konten tabel saat ini dan semua turunannya. Jika false (nilai default), tulis data hanya untuk tabel saat ini.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Biasanya, WriteXml metode menyimpan data hanya untuk tabel saat ini. Jika Anda ingin menyimpan data untuk tabel saat ini dan semua skema, metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

WriteXml Biasanya metode menulis data hanya untuk tabel saat ini. Untuk menulis data untuk tabel saat ini dan semua turunan, tabel terkait, panggil metode dengan parameter yang writeHierarchy diatur ke true.

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk

WriteXml(XmlWriter)

Sumber:
DataTable.cs
Sumber:
DataTable.cs
Sumber:
DataTable.cs

Menulis konten saat ini sebagai DataTable XML menggunakan yang ditentukan XmlWriter.

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)

Parameter

writer
XmlWriter

yang XmlWriter digunakan untuk menulis konten.

Keterangan

Metode ini WriteXml menyediakan cara untuk menulis data saja, atau data dan skema dari DataTable ke dalam dokumen XML, sedangkan WriteXmlSchema metode hanya menulis skema. Untuk menulis data dan skema, gunakan salah satu kelebihan beban yang menyertakan XmlWriteMode parameter , dan atur nilainya ke WriteSchema.

Perhatikan bahwa hal yang sama berlaku untuk ReadXml metode dan ReadXmlSchema , masing-masing. Untuk membaca data XML, atau skema dan data ke DataTabledalam , gunakan ReadXml metode . Untuk membaca skema saja, gunakan ReadXmlSchema metode .

Catatan

InvalidOperationException Akan dilemparkan jika jenis kolom dalam DataRow yang dibaca dari atau ditulis ke mengimplementasikan IDynamicMetaObjectProvider dan tidak mengimplementasikan IXmlSerializable.

Lihat juga

Berlaku untuk