DataTable.WriteXml Metódus

Definíció

Névtér:: System.Data

Szerelvény:: System.Data.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Az XML-fájl aktuális tartalmát DataTable írja le.

Túlterhelések

Name	Description
WriteXml(TextWriter, Boolean)	A megadott TextWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(TextWriter, XmlWriteMode)	Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott TextWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: .
WriteXml(String, XmlWriteMode)	Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott fájl és XmlWriteMode. A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: .
WriteXml(Stream, XmlWriteMode)	A megadott fájlhoz tartozó aktuális adatokat és opcionálisan a sémát írja a megadott fájlba DataTable a megadott XmlWriteModehasználatával. A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: .
WriteXml(XmlWriter, Boolean)	A megadott XmlWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat.
WriteXml(XmlWriter, XmlWriteMode)	Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott XmlWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: .
WriteXml(Stream, XmlWriteMode, Boolean)	A megadott fájlhoz tartozó aktuális adatokat és opcionálisan a sémát írja a megadott fájlba DataTable a megadott XmlWriteModehasználatával. A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(TextWriter, XmlWriteMode, Boolean)	Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott TextWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(String, Boolean)	A megadott fájl használatával XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(Stream, Boolean)	A megadott Streamparanccsal XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(XmlWriter, XmlWriteMode, Boolean)	Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott XmlWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(String)	A megadott fájl használatával XML-ként írja be az DataTable aktuális tartalmat.
WriteXml(TextWriter)	A megadott TextWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat.
WriteXml(Stream)	A megadott Streamparanccsal XML-ként írja be az DataTable aktuális tartalmat.
WriteXml(String, XmlWriteMode, Boolean)	Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott fájl és XmlWriteMode. A séma írásához állítsa a paraméter értékét a `mode` következőre `WriteSchema`: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a `writeHierarchy` következőre `true`: .
WriteXml(XmlWriter)	A megadott XmlWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat.

Példák

A következő konzolalkalmazás két DataTable példányt hoz létre, hozzáadja azokat egyhez DataSet, létrehoz egy DataRelation kapcsolódó táblát, majd a WriteXml metódussal írja a szülőtáblában lévő adatokat egy TextWriter. A példa azt mutatja be, hogy a paraméter milyen viselkedést mutat be, amikor a paramétert az writeHierarchy egyes értékeire állítja.

Note

Ez a példa bemutatja, hogyan használható a WriteXml egyik túlterhelt verziója. További elérhető példákért tekintse meg az egyes túlterhelési témaköröket.

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

A példa a következő kimenetet jeleníti meg a konzolablakban:

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

Megjegyzések

A WriteXml metódus lehetővé teszi, hogy csak adatokat írjon, vagy adatokat és sémákat is egy DataTable XML-dokumentumba, míg a WriteXmlSchema metódus csak a sémát írja. Adatok és séma írásához használja a paramétert tartalmazó XmlWriteMode túlterhelések egyikét, és állítsa az értékét a következőre WriteSchema: .

Vegye figyelembe, hogy ugyanez igaz a metódusokra és ReadXmlSchema a ReadXml metódusokra is. Az XML-adatok, illetve a sémák és az adatok beolvasásához DataTablehasználja a metódust ReadXml . A séma olvasásához használja a metódust ReadXmlSchema .

Note

A InvalidOperationException rendszer akkor küld egy oszloptípust, ha a rendszer beolvassa vagy implementálja IDynamicMetaObjectProvider azokatDataRow, és nem implementálja IXmlSerializableazokat.

WriteXml(TextWriter, Boolean)

A megadott TextWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

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)

Paraméterek

writer: TextWriter

A TextWriter tartalom írásának célja.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Példák

A következő konzolalkalmazás két DataTable példányt hoz létre, hozzáadja azokat egyhez DataSet, létrehoz egy DataRelation kapcsolódó táblát, majd a WriteXml metódussal írja a szülőtáblában lévő adatokat egy TextWriter. A példa bemutatja a paraméter truebeállításának viselkedésétwriteHierarchy.

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

Megjegyzések

A metódus általában WriteXml csak az aktuális táblához írja az adatokat. Az aktuális tábla és annak összes leszármazottja, a kapcsolódó táblák adatainak megírásához hívja meg a metódust truea writeHierarchy paraméter beállításával.

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(TextWriter, XmlWriteMode)

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)

Paraméterek

writer: TextWriter

A TextWriter dokumentum írásához használt.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(String, XmlWriteMode)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott fájl és XmlWriteMode. A séma írásához állítsa a paraméter értékét a mode következőre 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)

Paraméterek

fileName: String

Annak a fájlnak a neve, amelyhez az adatok meg lesznek írva.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(Stream, XmlWriteMode)

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)

Paraméterek

stream: Stream

Az a stream, amelyre az adatok meg lesznek írva.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(XmlWriter, Boolean)

A megadott XmlWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat.

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)

Paraméterek

writer: XmlWriter

A XmlWriter tartalom megírásának célja.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Megjegyzések

A metódus általában WriteXml csak az aktuális táblához írja az adatokat. Az aktuális tábla és annak teljes leszármazottja, a kapcsolódó táblák adatainak megírásához hívja meg a metódust truea writeHierarchy paraméter beállításával.

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(XmlWriter, XmlWriteMode)

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)

Paraméterek

writer: XmlWriter

A XmlWriter dokumentum írásához használt.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(Stream, XmlWriteMode, Boolean)

A megadott fájlhoz tartozó aktuális adatokat és opcionálisan a sémát írja a megadott fájlba DataTable a megadott XmlWriteModehasználatával. A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

public:
 void WriteXml(System::IO::Stream ^ stream, System::Data::XmlWriteMode mode, bool writeHierarchy);

public void WriteXml(System.IO.Stream stream, System.Data.XmlWriteMode mode, bool writeHierarchy);

member this.WriteXml : System.IO.Stream * System.Data.XmlWriteMode * bool -> unit

Public Sub WriteXml (stream As Stream, mode As XmlWriteMode, writeHierarchy As Boolean)

Paraméterek

stream: Stream

Az a stream, amelyre az adatok meg lesznek írva.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Megjegyzések

A WriteXml metódus lehetővé teszi, hogy csak adatokat írjon, vagy adatokat és sémákat is egy DataTable XML-dokumentumba, míg a WriteXmlSchema metódus csak a sémát írja. Adatok és séma írásához használja a paramétert tartalmazó XmlWriteMode túlterhelések egyikét, és állítsa az értékét a következőre WriteSchema: .

A metódus általában csak az WriteXml aktuális táblára menti az adatokat. A WriteXml metódus lehetővé teszi, hogy csak adatokat írjon, vagy adatokat és sémákat is egy DataTable XML-dokumentumba, míg a WriteXmlSchema metódus csak a sémát írja. Adatok és séma írásához használja a paramétert tartalmazó XmlWriteMode túlterhelések egyikét, és állítsa az értékét a következőre WriteSchema: .

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(TextWriter, XmlWriteMode, Boolean)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott TextWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

public:
 void WriteXml(System::IO::TextWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);

public void WriteXml(System.IO.TextWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);

member this.WriteXml : System.IO.TextWriter * System.Data.XmlWriteMode * bool -> unit

Public Sub WriteXml (writer As TextWriter, mode As XmlWriteMode, writeHierarchy As Boolean)

Paraméterek

writer: TextWriter

A TextWriter dokumentum írásához használt.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Példák

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

A példa a következő kimenetet jeleníti meg a konzolablakban:

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

Megjegyzések

A metódus általában csak az WriteXml aktuális táblára menti az adatokat. A WriteXml metódus lehetővé teszi, hogy csak adatokat írjon, vagy adatokat és sémákat is egy DataTable XML-dokumentumba, míg a WriteXmlSchema metódus csak a sémát írja. Adatok és séma írásához használja a paramétert tartalmazó XmlWriteMode túlterhelések egyikét, és állítsa az értékét a következőre WriteSchema: .

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(String, Boolean)

A megadott fájl használatával XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

public:
 void WriteXml(System::String ^ fileName, bool writeHierarchy);

public void WriteXml(string fileName, bool writeHierarchy);

member this.WriteXml : string * bool -> unit

Public Sub WriteXml (fileName As String, writeHierarchy As Boolean)

Paraméterek

fileName: String

Az a fájl, amelyhez az XML-adatokat meg szeretné írni.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(Stream, Boolean)

A megadott Streamparanccsal XML-ként írja be az DataTable aktuális tartalmat. A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

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)

Paraméterek

stream: Stream

Az a stream, amelyre az adatok meg lesznek írva.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Megjegyzések

WriteXmlSchema A metódussal xml-dokumentumba írhatja a sémátDataTable. A séma tábla-, relációs és kényszerdefiníciókat tartalmaz.

Az XML-séma az XSD szabvány használatával van megírva.

Ha xml-dokumentumba szeretné írni az adatokat, használja a metódust WriteXml .

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott XmlWriter és XmlWriteModea . A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

public:
 void WriteXml(System::Xml::XmlWriter ^ writer, System::Data::XmlWriteMode mode, bool writeHierarchy);

public void WriteXml(System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode, bool writeHierarchy);

member this.WriteXml : System.Xml.XmlWriter * System.Data.XmlWriteMode * bool -> unit

Public Sub WriteXml (writer As XmlWriter, mode As XmlWriteMode, writeHierarchy As Boolean)

Paraméterek

writer: XmlWriter

A XmlWriter dokumentum írásához használt.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(String)

A megadott fájl használatával XML-ként írja be az DataTable aktuális tartalmat.

public:
 void WriteXml(System::String ^ fileName);

public void WriteXml(string fileName);

member this.WriteXml : string -> unit

Public Sub WriteXml (fileName As String)

Paraméterek

fileName: String

Az a fájl, amelyhez az XML-adatokat meg szeretné írni.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(TextWriter)

A megadott TextWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat.

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)

Paraméterek

writer: TextWriter

A TextWriter tartalom írásának célja.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(Stream)

A megadott Streamparanccsal XML-ként írja be az DataTable aktuális tartalmat.

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)

Paraméterek

stream: Stream

Az a stream, amelyre az adatok meg lesznek írva.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(String, XmlWriteMode, Boolean)

Megírja az aktuális adatokat, és opcionálisan a sémát a DataTable megadott fájl és XmlWriteMode. A séma írásához állítsa a paraméter értékét a mode következőre WriteSchema: . A tábla és az összes leszármazott adatainak mentéséhez állítsa a paramétert a writeHierarchy következőre true: .

public:
 void WriteXml(System::String ^ fileName, System::Data::XmlWriteMode mode, bool writeHierarchy);

public void WriteXml(string fileName, System.Data.XmlWriteMode mode, bool writeHierarchy);

member this.WriteXml : string * System.Data.XmlWriteMode * bool -> unit

Public Sub WriteXml (fileName As String, mode As XmlWriteMode, writeHierarchy As Boolean)

Paraméterek

fileName: String

Annak a fájlnak a neve, amelyhez az adatok meg lesznek írva.

mode: XmlWriteMode

Az egyik XmlWriteMode érték.

writeHierarchy: Boolean

Ha true, írja be az aktuális táblázat tartalmát és annak összes leszármazottját. Ha false (az alapértelmezett érték), csak az aktuális táblához írja be az adatokat.

Megjegyzések

A metódus általában csak az WriteXml aktuális táblára menti az adatokat. Ha az aktuális táblához és az összes sémához szeretné menteni az adatokat, a WriteXml metódus lehetővé teszi, hogy csak az adatokat, vagy az adatokat és a sémákat DataTable egy XML-dokumentumba írja, míg a WriteXmlSchema metódus csak a sémát írja. Adatok és séma írásához használja a paramétert tartalmazó XmlWriteMode túlterhelések egyikét, és állítsa az értékét a következőre WriteSchema: .

A metódus általában WriteXml csak az aktuális táblához írja az adatokat. Az aktuális tábla és az összes leszármazott, kapcsolódó tábla adatainak megírásához hívja meg a metódust truea writeHierarchy paraméter beállításával.

Note

Lásd még

DataTables

A következőre érvényes:

WriteXml(XmlWriter)

A megadott XmlWriterparanccsal XML-ként írja be az DataTable aktuális tartalmat.

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)

Paraméterek

writer: XmlWriter

A XmlWriter tartalom megírásának célja.

Megjegyzések

Note

Lásd még

DataTables

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?