DataTable.WriteXml Метод

Определение

Пространство имен:: System.Data

Сборка:: System.Data.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает текущее содержимое DataTable xml.

Перегрузки

Имя	Описание
WriteXml(TextWriter, Boolean)	Записывает текущее содержимое DataTable XML с помощью указанного TextWriter. Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(TextWriter, XmlWriteMode)	Записывает текущие данные и, при необходимости, схему для DataTable использования указанного TextWriter и XmlWriteMode. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` .
WriteXml(String, XmlWriteMode)	Записывает текущие данные и, при необходимости, схему для DataTable использования указанного файла и XmlWriteMode. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` .
WriteXml(Stream, XmlWriteMode)	Записывает текущие данные и при необходимости схему для DataTable указанного файла с помощью указанного XmlWriteModeфайла. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` .
WriteXml(XmlWriter, Boolean)	Записывает текущее содержимое DataTable XML с помощью указанного XmlWriter.
WriteXml(XmlWriter, XmlWriteMode)	Записывает текущие данные и, при необходимости, схему для DataTable использования указанного XmlWriter и XmlWriteMode. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` .
WriteXml(Stream, XmlWriteMode, Boolean)	Записывает текущие данные и при необходимости схему для DataTable указанного файла с помощью указанного XmlWriteModeфайла. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` . Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(TextWriter, XmlWriteMode, Boolean)	Записывает текущие данные и, при необходимости, схему для DataTable использования указанного TextWriter и XmlWriteMode. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` . Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(String, Boolean)	Записывает текущее содержимое DataTable XML с помощью указанного файла. Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(Stream, Boolean)	Записывает текущее содержимое DataTable XML с помощью указанного Stream. Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(XmlWriter, XmlWriteMode, Boolean)	Записывает текущие данные и, при необходимости, схему для DataTable использования указанного XmlWriter и XmlWriteMode. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` . Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(String)	Записывает текущее содержимое DataTable XML с помощью указанного файла.
WriteXml(TextWriter)	Записывает текущее содержимое DataTable XML с помощью указанного TextWriter.
WriteXml(Stream)	Записывает текущее содержимое DataTable XML с помощью указанного Stream.
WriteXml(String, XmlWriteMode, Boolean)	Записывает текущие данные и, при необходимости, схему для DataTable использования указанного файла и XmlWriteMode. Чтобы написать схему, задайте для параметра `WriteSchema`значение `mode` . Чтобы сохранить данные для таблицы и всех его потомков, задайте для `writeHierarchy` параметра `true`значение .
WriteXml(XmlWriter)	Записывает текущее содержимое DataTable XML с помощью указанного XmlWriter.

Примеры

Следующее консольное приложение создает два DataTable экземпляра, добавляет каждый из DataSetних в таблицу, создает DataRelation две таблицы, а затем использует WriteXml метод для записи данных, содержащихся в родительской таблице TextWriter. В примере показано поведение при задании writeHierarchy параметра для каждого из его значений.

Note

В этом примере показано, как использовать одну из перегруженных версий WriteXml. Другие примеры, которые могут быть доступны, см. в отдельных разделах перегрузки.

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

В примере отображаются следующие выходные данные в окне консоли:

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

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих XmlWriteMode параметр, и задайте для него значение WriteSchema.

Обратите внимание, что то же самое верно для ReadXml методов и ReadXmlSchema методов соответственно. Для чтения XML-данных или схемы и данных в DataTableметод используйте ReadXml этот метод. Чтобы прочитать только схему ReadXmlSchema , используйте этот метод.

Note

Вызывается InvalidOperationException , если тип столбца при DataRow чтении или записи для реализации IDynamicMetaObjectProvider и не реализуется IXmlSerializable.

WriteXml(TextWriter, Boolean)

Записывает текущее содержимое DataTable XML с помощью указанного TextWriter. Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

writer: TextWriter

Значение TextWriter , с помощью которого нужно написать содержимое.

writeHierarchy: Boolean

Если true, напишите содержимое текущей таблицы и всех его потомков. Если false (значение по умолчанию), запишите данные только для текущей таблицы.

Примеры

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

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

WriteXml Обычно метод записывает данные только для текущей таблицы. Чтобы записать данные для текущей таблицы и всех его потомков, связанных таблиц, вызовите метод с заданным параметром writeHierarchytrue.

Note

См. также раздел

DataTables

Применяется к

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)

Параметры

writer: TextWriter

Используется TextWriter для записи документа.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(String, XmlWriteMode)

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

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

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

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

Параметры

fileName: String

Имя файла, в который записываются данные.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

См. также раздел

DataTables

Применяется к

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)

Параметры

stream: Stream

Поток, в который записываются данные.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(XmlWriter, Boolean)

Записывает текущее содержимое DataTable XML с помощью указанного XmlWriter.

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)

Параметры

writer: XmlWriter

Значение XmlWriter , с помощью которого нужно написать содержимое.

writeHierarchy: Boolean

WriteXml Обычно метод записывает данные только для текущей таблицы. Чтобы записать данные для текущей таблицы и всего потомка, связанные таблицы, вызовите метод с заданным параметром writeHierarchytrue.

Note

См. также раздел

DataTables

Применяется к

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)

Параметры

writer: XmlWriter

Используется XmlWriter для записи документа.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

См. также раздел

DataTables

Применяется к

WriteXml(Stream, XmlWriteMode, Boolean)

Записывает текущие данные и при необходимости схему для DataTable указанного файла с помощью указанного XmlWriteModeфайла. Чтобы написать схему, задайте для параметра WriteSchemaзначение mode . Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

stream: Stream

Поток, в который записываются данные.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

writeHierarchy: Boolean

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

WriteXml Обычно метод сохраняет данные только для текущей таблицы. Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(TextWriter, XmlWriteMode, Boolean)

Записывает текущие данные и, при необходимости, схему для DataTable использования указанного TextWriter и XmlWriteMode. Чтобы написать схему, задайте для параметра WriteSchemaзначение mode . Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

writer: TextWriter

Используется TextWriter для записи документа.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

writeHierarchy: Boolean

Примеры

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

В примере отображаются следующие выходные данные в окне консоли:

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

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

WriteXml Обычно метод сохраняет данные только для текущей таблицы. Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(String, Boolean)

Записывает текущее содержимое DataTable XML с помощью указанного файла. Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

fileName: String

Файл, в который нужно записать XML-данные.

writeHierarchy: Boolean

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(Stream, Boolean)

Записывает текущее содержимое DataTable XML с помощью указанного Stream. Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

stream: Stream

Поток, в который записываются данные.

writeHierarchy: Boolean

См. также раздел

DataTables

Применяется к

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Записывает текущие данные и, при необходимости, схему для DataTable использования указанного XmlWriter и XmlWriteMode. Чтобы написать схему, задайте для параметра WriteSchemaзначение mode . Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

writer: XmlWriter

Используется XmlWriter для записи документа.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

writeHierarchy: Boolean

См. также раздел

DataTables

Применяется к

WriteXml(String)

Записывает текущее содержимое DataTable XML с помощью указанного файла.

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

public void WriteXml(string fileName);

member this.WriteXml : string -> unit

Public Sub WriteXml (fileName As String)

Параметры

fileName: String

Файл, в который нужно записать XML-данные.

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(TextWriter)

Записывает текущее содержимое DataTable XML с помощью указанного TextWriter.

public:
 void WriteXml(System::IO::TextWriter ^ writer);

public void WriteXml(System.IO.TextWriter writer);

member this.WriteXml : System.IO.TextWriter -> unit

Public Sub WriteXml (writer As TextWriter)

Параметры

writer: TextWriter

Значение TextWriter , с помощью которого нужно написать содержимое.

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(Stream)

Записывает текущее содержимое DataTable XML с помощью указанного Stream.

public:
 void WriteXml(System::IO::Stream ^ stream);

public void WriteXml(System.IO.Stream stream);

member this.WriteXml : System.IO.Stream -> unit

Public Sub WriteXml (stream As Stream)

Параметры

stream: Stream

Поток, в который записываются данные.

Метод WriteXml предоставляет способ записи только данных или как данных, так и схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих параметр, и задайте для нее XmlWriteMode значение WriteSchema.

Note

См. также раздел

DataTables

Применяется к

WriteXml(String, XmlWriteMode, Boolean)

Записывает текущие данные и, при необходимости, схему для DataTable использования указанного файла и XmlWriteMode. Чтобы написать схему, задайте для параметра WriteSchemaзначение mode . Чтобы сохранить данные для таблицы и всех его потомков, задайте для writeHierarchy параметра 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)

Параметры

fileName: String

Имя файла, в который записываются данные.

mode: XmlWriteMode

Одно из значений XmlWriteMode .

writeHierarchy: Boolean

WriteXml Обычно метод сохраняет данные только для текущей таблицы. Если вы хотите сохранить данные для текущей таблицы и всей схемы, WriteXml метод предоставляет способ записи только данных или схемы из DataTable XML-документа, в то время как WriteXmlSchema метод записывает только схему. Чтобы записать данные и схему, используйте одну из перегрузок, включающих XmlWriteMode параметр, и задайте для него значение WriteSchema.

WriteXml Обычно метод записывает данные только для текущей таблицы. Чтобы записать данные для текущей таблицы и всех потомков, связанных таблиц, вызовите метод с заданным параметром writeHierarchytrue.

Note

См. также раздел

DataTables

Применяется к

WriteXml(XmlWriter)

Записывает текущее содержимое DataTable XML с помощью указанного XmlWriter.

public:
 void WriteXml(System::Xml::XmlWriter ^ writer);

public void WriteXml(System.Xml.XmlWriter writer);

member this.WriteXml : System.Xml.XmlWriter -> unit

Public Sub WriteXml (writer As XmlWriter)

Параметры

writer: XmlWriter

Значение XmlWriter , с помощью которого нужно написать содержимое.

См. также раздел

DataTables

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

DataTable.WriteXml Метод

Определение

Перегрузки

Примеры

Комментарии

WriteXml(TextWriter, Boolean)

Параметры

Примеры

Комментарии

См. также раздел

Применяется к

WriteXml(TextWriter, XmlWriteMode)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(String, XmlWriteMode)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(Stream, XmlWriteMode)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(XmlWriter, Boolean)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(XmlWriter, XmlWriteMode)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(Stream, XmlWriteMode, Boolean)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(TextWriter, XmlWriteMode, Boolean)

Параметры

Примеры

Комментарии

См. также раздел

Применяется к

WriteXml(String, Boolean)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(Stream, Boolean)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(XmlWriter, XmlWriteMode, Boolean)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(String)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(TextWriter)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(Stream)

Параметры

Комментарии

См. также раздел

Применяется к

WriteXml(String, XmlWriteMode, Boolean)

Параметры

Комментарии