Прочитать на английском

Поделиться через


DataSet.WriteXml Метод

Определение

Записывает XML-данные и по возможности схемы из DataSet.

Перегрузки

WriteXml(XmlWriter, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet с помощью указанных XmlWriter и XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

WriteXml(String, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet в указанный файл с помощью заданного объекта XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

WriteXml(TextWriter, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet с помощью указанных TextWriter и XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

WriteXml(Stream, XmlWriteMode)

Записывает текущие данные и по возможности схему для DataSet с помощью указанных Stream и XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

WriteXml(String)

Записывает текущие данные для DataSet в указанный файл.

WriteXml(TextWriter)

Записывает текущие данные для DataSet с помощью указанного объекта TextWriter.

WriteXml(XmlWriter)

Записывает текущие данные для DataSet в указанный класс XmlWriter.

WriteXml(Stream)

Записывает текущие данные для DataSet с помощью указанного объекта Stream.

WriteXml(XmlWriter, XmlWriteMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные и по возможности схему для DataSet с помощью указанных XmlWriter и XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

C#
public void WriteXml (System.Xml.XmlWriter? writer, System.Data.XmlWriteMode mode);
C#
public void WriteXml (System.Xml.XmlWriter writer, System.Data.XmlWriteMode mode);

Параметры

writer
XmlWriter

Класс XmlWriter, с помощью которого осуществляется запись.

mode
XmlWriteMode

Одно из значений перечисления XmlWriteMode.

Примеры

В следующем примере создается System.IO.FileStream объект , который используется для создания нового XmlTextWriterобъекта . Объект XmlTextWriter используется с методом WriteXml для записи XML-документа.

C#
private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Create the FileStream to write with.
    System.IO.FileStream stream = new System.IO.FileStream
        (filename, System.IO.FileMode.Create);

    // Create an XmlTextWriter with the fileStream.
    System.Xml.XmlTextWriter xmlWriter =
        new System.Xml.XmlTextWriter(stream,
        System.Text.Encoding.Unicode);

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(xmlWriter);
    xmlWriter.Close();
}

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(String, XmlWriteMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные и по возможности схему для DataSet в указанный файл с помощью заданного объекта XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

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

Параметры

fileName
String

Имя файла (включая путь), в который производится запись.

mode
XmlWriteMode

Одно из значений перечисления XmlWriteMode.

Исключения

Для поля FileIOPermission не задан класс Write.

Примеры

В следующем примере метод используется WriteXml для записи XML-документа.

C#
private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(filename);
}

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(TextWriter, XmlWriteMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные и по возможности схему для DataSet с помощью указанных TextWriter и XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

C#
public void WriteXml (System.IO.TextWriter? writer, System.Data.XmlWriteMode mode);
C#
public void WriteXml (System.IO.TextWriter writer, System.Data.XmlWriteMode mode);

Параметры

writer
TextWriter

Объект TextWriter, используемый для записи документа.

mode
XmlWriteMode

Одно из значений перечисления XmlWriteMode.

Примеры

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

C#
private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();

    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(Stream, XmlWriteMode)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные и по возможности схему для DataSet с помощью указанных Stream и XmlWriteMode. Чтобы записать схему, задайте в параметре mode значение WriteSchema.

C#
public void WriteXml (System.IO.Stream? stream, System.Data.XmlWriteMode mode);
C#
public void WriteXml (System.IO.Stream stream, System.Data.XmlWriteMode mode);

Параметры

stream
Stream

Объект Stream, используемый для записи в файл.

mode
XmlWriteMode

Одно из значений перечисления XmlWriteMode.

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(String)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные для DataSet в указанный файл.

C#
public void WriteXml (string fileName);

Параметры

fileName
String

Имя файла (включая путь), в который производится запись.

Исключения

Для поля FileIOPermission не задан класс Write.

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(TextWriter)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные для DataSet с помощью указанного объекта TextWriter.

C#
public void WriteXml (System.IO.TextWriter? writer);
C#
public void WriteXml (System.IO.TextWriter writer);

Параметры

writer
TextWriter

Объект TextWriter, используемый для записи.

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(XmlWriter)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные для DataSet в указанный класс XmlWriter.

C#
public void WriteXml (System.Xml.XmlWriter? writer);
C#
public void WriteXml (System.Xml.XmlWriter writer);

Параметры

writer
XmlWriter

Класс XmlWriter, с помощью которого осуществляется запись.

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

WriteXml(Stream)

Исходный код:
DataSet.cs
Исходный код:
DataSet.cs
Исходный код:
DataSet.cs

Записывает текущие данные для DataSet с помощью указанного объекта Stream.

C#
public void WriteXml (System.IO.Stream? stream);
C#
public void WriteXml (System.IO.Stream stream);

Параметры

stream
Stream

Объект Stream, используемый для записи в файл.

Примеры

В следующем примере создается System.IO.FileStream объект . Затем объект используется с методом WriteXml для записи XML-документа.

C#
private void WriteXmlToFile(DataSet thisDataSet)
{
    if (thisDataSet == null) { return; }

    // Create a file name to write to.
    string filename = "XmlDoc.xml";

    // Create the FileStream to write with.
    System.IO.FileStream stream = new System.IO.FileStream
        (filename, System.IO.FileMode.Create);

    // Write to the file with the WriteXml method.
    thisDataSet.WriteXml(stream);
}

Комментарии

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

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

Примечание

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

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

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1