XmlWriter.Create Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает новый экземпляр XmlWriter.
Перегрузки
| Имя | Описание |
|---|---|
| Create(StringBuilder, XmlWriterSettings) |
Создает новый XmlWriter экземпляр с помощью StringBuilder объектов и XmlWriterSettings объектов. |
| Create(String, XmlWriterSettings) |
Создает новый XmlWriter экземпляр с помощью имени файла и XmlWriterSettings объекта. |
| Create(TextWriter, XmlWriterSettings) |
Создает новый XmlWriter экземпляр с помощью TextWriter объектов и XmlWriterSettings объектов. |
| Create(Stream, XmlWriterSettings) |
Создает новый XmlWriter экземпляр с помощью потока и XmlWriterSettings объекта. |
| Create(XmlWriter, XmlWriterSettings) |
Создает новый XmlWriter экземпляр с помощью указанных XmlWriter и XmlWriterSettings объектов. |
| Create(StringBuilder) |
Создает новый XmlWriter экземпляр с помощью указанного StringBuilder. |
| Create(String) |
Создает новый XmlWriter экземпляр с помощью указанного имени файла. |
| Create(TextWriter) |
Создает новый XmlWriter экземпляр с помощью указанного TextWriter. |
| Create(Stream) |
Создает новый XmlWriter экземпляр с помощью указанного потока. |
| Create(XmlWriter) |
Создает новый XmlWriter экземпляр с помощью указанного XmlWriter объекта. |
Комментарии
Некоторые Create перегрузки включают settings параметр, принимаюющий XmlWriterSettings объект. Этот объект можно использовать для:
Укажите функции, поддерживаемые для созданного XmlWriter объекта.
Повторно используйте XmlWriterSettings объект для создания нескольких объектов записи. Объект XmlWriterSettings копируется и помечается только для чтения для каждого созданного модуля записи. Изменения параметров в экземпляре XmlWriterSettings не влияют на существующие записи с теми же параметрами. Таким образом, можно использовать одни и те же параметры для создания нескольких писателей с одной и той же функциональностью. Кроме того, можно изменить параметры экземпляра XmlWriterSettings и создать новый модуль записи с другим набором функций.
Добавьте функции в существующий модуль записи XML. Метод Create может принимать другой XmlWriter объект. Базовый XmlWriter объект не должен быть модуль записи XML, созданный статическим Create методом. Например, можно указать определяемый пользователем модуль записи XML, чтобы добавить в нее дополнительные функции.
Воспользуйтесь всеми преимуществами таких функций, как проверка соответствия и соответствие рекомендациям XML 1.0 , которые доступны только для XmlWriter объектов, созданных статическим Create методом.
Если вы используете перегрузку CreateXmlWriterSettings , которая не принимает объект, используются следующие параметры записи по умолчанию:
| Setting | По умолчанию |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Два пробела |
| NamespaceHandling | Default (без удаления) |
| NewLineChars |
\r\n (возврат каретки, канал строки) для платформ, отличных от Unix, или \n (канал строк) для платформ Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Note
Хотя платформа .NET Framework включает класс XmlTextWriter, который представляет собой конкретную реализацию класса XmlWriter, рекомендуется создать экземпляры XmlWriter с помощью метода Create.
Create(StringBuilder, XmlWriterSettings)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью StringBuilder объектов и XmlWriterSettings объектов.
public:
static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);
static member Create : System.Text.StringBuilder * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As StringBuilder, settings As XmlWriterSettings) As XmlWriter
Параметры
- output
- StringBuilder
Значение StringBuilder , в которое нужно написать. Содержимое, написанное приложением XmlWriter , StringBuilderдобавляется в .
- settings
- XmlWriterSettings
Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.
Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.
Возвращаемое значение
Объект XmlWriter.
Исключения
output равно null.
Применяется к
Create(String, XmlWriterSettings)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью имени файла и XmlWriterSettings объекта.
public:
static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(string outputFileName, System.Xml.XmlWriterSettings? settings);
public static System.Xml.XmlWriter Create(string outputFileName, System.Xml.XmlWriterSettings settings);
static member Create : string * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String, settings As XmlWriterSettings) As XmlWriter
Параметры
- outputFileName
- String
Файл, в который требуется записать. Создает XmlWriter файл по указанному пути и записывает его в текстовый синтаксис XML 1.0. Должен outputFileName быть путь к файловой системе.
- settings
- XmlWriterSettings
Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.
Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.
Возвращаемое значение
Объект XmlWriter.
Исключения
outputFileName равно null.
Примеры
В следующем примере создается XmlWriter объект с определенными параметрами.
using System;
using System.IO;
using System.Xml;
using System.Text;
public class Sample {
public static void Main() {
XmlWriter writer = null;
try {
// Create an XmlWriterSettings object with the correct options.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = ("\t");
settings.OmitXmlDeclaration = true;
// Create the XmlWriter object and write some content.
writer = XmlWriter.Create("data.xml", settings);
writer.WriteStartElement("book");
writer.WriteElementString("item", "tesing");
writer.WriteEndElement();
writer.Flush();
}
finally {
if (writer != null)
writer.Close();
}
}
}
Imports System.IO
Imports System.Xml
Imports System.Text
Public Class Sample
Public Shared Sub Main()
Dim writer As XmlWriter = Nothing
Try
' Create an XmlWriterSettings object with the correct options.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.Indent = true
settings.IndentChars = (ControlChars.Tab)
settings.OmitXmlDeclaration = true
' Create the XmlWriter object and write some content.
writer = XmlWriter.Create("data.xml", settings)
writer.WriteStartElement("book")
writer.WriteElementString("item", "tesing")
writer.WriteEndElement()
writer.Flush()
Finally
If Not (writer Is Nothing) Then
writer.Close()
End If
End Try
End Sub
End Class
Применяется к
Create(TextWriter, XmlWriterSettings)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью TextWriter объектов и XmlWriterSettings объектов.
public:
static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);
static member Create : System.IO.TextWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As TextWriter, settings As XmlWriterSettings) As XmlWriter
Параметры
- output
- TextWriter
Имя TextWriter , в которое требуется написать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный TextWriter.
- settings
- XmlWriterSettings
Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.
Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.
Возвращаемое значение
Объект XmlWriter.
Исключения
output равно null.
Примеры
В следующем примере записывается XML-строка.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
StringWriter sw = new StringWriter();
using (XmlWriter writer = XmlWriter.Create(sw, settings))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
String output = sw.ToString();
}
Dim settings As New XmlWriterSettings()
settings.OmitXmlDeclaration = True
Dim sw As New StringWriter()
Using writer As XmlWriter = XmlWriter.Create(sw, settings)
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
Dim output As String = sw.ToString()
End Using
Применяется к
Create(Stream, XmlWriterSettings)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью потока и XmlWriterSettings объекта.
public:
static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.IO.Stream output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.IO.Stream output, System.Xml.XmlWriterSettings? settings);
static member Create : System.IO.Stream * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As Stream, settings As XmlWriterSettings) As XmlWriter
Параметры
- output
- Stream
Поток, в который требуется записать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный поток.
- settings
- XmlWriterSettings
Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.
Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.
Возвращаемое значение
Объект XmlWriter.
Исключения
output равно null.
Примеры
В следующем примере фрагмент XML записывается в поток памяти.
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;
// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();
// Do additional processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false
' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()
' Do additional processing on the stream.
Комментарии
XmlWriter всегда записывает метку порядка байтов (BOM) в базовый поток данных; однако некоторые потоки не должны иметь BOM. Чтобы опустить BOM, создайте новый XmlWriterSettings объект и задайте для свойства Кодировки новый UTF8Encoding объект с логическим значением в конструкторе, равным false.
Применяется к
Create(XmlWriter, XmlWriterSettings)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью указанных XmlWriter и XmlWriterSettings объектов.
public:
static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output, System::Xml::XmlWriterSettings ^ settings);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);
static member Create : System.Xml.XmlWriter * System.Xml.XmlWriterSettings -> System.Xml.XmlWriter
Public Shared Function Create (output As XmlWriter, settings As XmlWriterSettings) As XmlWriter
Параметры
- output
- XmlWriter
Объект XmlWriter , который требуется использовать в качестве базового модуля записи.
- settings
- XmlWriterSettings
Объект XmlWriterSettings , используемый для настройки нового XmlWriter экземпляра. Если это nullтак, XmlWriterSettings используется параметр по умолчанию.
Если используется XmlWriter с методом Transform(String, XmlWriter) , следует использовать OutputSettings свойство для получения XmlWriterSettings объекта с правильными параметрами. Это гарантирует, что созданный XmlWriter объект имеет правильные параметры выходных данных.
Возвращаемое значение
Объект XmlWriter , который упакован вокруг указанного XmlWriter объекта.
Исключения
output равно null.
Комментарии
Этот метод позволяет добавлять дополнительные функции в базовый XmlWriter объект. Базовый XmlWriter объект может быть объектом, созданным XmlWriter.Create методом, или объектом, созданным XmlTextWriter с помощью реализации.
Применяется к
Create(StringBuilder)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью указанного StringBuilder.
public:
static System::Xml::XmlWriter ^ Create(System::Text::StringBuilder ^ output);
public static System.Xml.XmlWriter Create(System.Text.StringBuilder output);
static member Create : System.Text.StringBuilder -> System.Xml.XmlWriter
Public Shared Function Create (output As StringBuilder) As XmlWriter
Параметры
- output
- StringBuilder
Значение StringBuilder , в которое нужно написать. Содержимое, написанное приложением XmlWriter , StringBuilderдобавляется в .
Возвращаемое значение
Объект XmlWriter.
Исключения
output равно null.
Комментарии
При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.
| Setting | По умолчанию |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Два пробела |
| NamespaceHandling | Default (без удаления) |
| NewLineChars |
\r\n (возврат каретки, канал строки) для платформ, отличных от Unix, или \n (канал строк) для платформ Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Если вы хотите указать функции для поддержки созданного модуля записи XML, используйте перегрузку, XmlWriterSettings принимающую объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.
Применяется к
Create(String)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью указанного имени файла.
public:
static System::Xml::XmlWriter ^ Create(System::String ^ outputFileName);
public static System.Xml.XmlWriter Create(string outputFileName);
static member Create : string -> System.Xml.XmlWriter
Public Shared Function Create (outputFileName As String) As XmlWriter
Параметры
- outputFileName
- String
Файл, в который требуется записать. Создает XmlWriter файл по указанному пути и записывает его в текстовый синтаксис XML 1.0. Должен outputFileName быть путь к файловой системе.
Возвращаемое значение
Объект XmlWriter.
Исключения
outputFileName равно null.
Примеры
В следующем примере создается XmlWriter объект и записывается узел книги.
using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
}
Using writer As XmlWriter = XmlWriter.Create("output.xml")
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
End Using
Комментарии
При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.
| Setting | По умолчанию |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Два пробела |
| NamespaceHandling | Default (без удаления) |
| NewLineChars |
\r\n (возврат каретки, канал строки) для платформ, отличных от Unix, или \n (канал строк) для платформ Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Если вы хотите указать функции для поддержки созданного модуля записи XML, используйте перегрузку, XmlWriterSettings принимающую объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.
Применяется к
Create(TextWriter)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью указанного TextWriter.
public:
static System::Xml::XmlWriter ^ Create(System::IO::TextWriter ^ output);
public static System.Xml.XmlWriter Create(System.IO.TextWriter output);
static member Create : System.IO.TextWriter -> System.Xml.XmlWriter
Public Shared Function Create (output As TextWriter) As XmlWriter
Параметры
- output
- TextWriter
Имя TextWriter , в которое требуется написать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный TextWriter.
Возвращаемое значение
Объект XmlWriter.
Исключения
output равно null.
Примеры
В следующем примере создается модуль записи, который выводится в консоль.
using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
writer.WriteStartElement("book");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
writer.Flush();
}
Using writer As XmlWriter = XmlWriter.Create(Console.Out)
writer.WriteStartElement("book")
writer.WriteElementString("price", "19.95")
writer.WriteEndElement()
writer.Flush()
End Using
Комментарии
При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.
| Setting | По умолчанию |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Два пробела |
| NamespaceHandling | Default (без удаления) |
| NewLineChars |
\r\n (возврат каретки, канал строки) для платформ, отличных от Unix, или \n (канал строк) для платформ Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Если вы хотите указать функции для поддержки созданного модуля записи, используйте перегрузку, которая принимает XmlWriterSettings объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.
Применяется к
Create(Stream)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
Создает новый XmlWriter экземпляр с помощью указанного потока.
public:
static System::Xml::XmlWriter ^ Create(System::IO::Stream ^ output);
public static System.Xml.XmlWriter Create(System.IO.Stream output);
static member Create : System.IO.Stream -> System.Xml.XmlWriter
Public Shared Function Create (output As Stream) As XmlWriter
Параметры
- output
- Stream
Поток, в который требуется записать. Синтаксис XmlWriter текста XML 1.0 записывается и добавляет его в указанный поток.
Возвращаемое значение
Объект XmlWriter.
Исключения
output равно null.
Примеры
В следующем примере фрагмент XML записывается в поток памяти. (Он использует перегрузку Create(Stream, XmlWriterSettings) , которая также настраивает параметры для нового экземпляра модуля записи XML.)
XmlWriterSettings settings = new XmlWriterSettings();
settings.OmitXmlDeclaration = true;
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.CloseOutput = false;
// Create the XmlWriter object and write some content.
MemoryStream strm = new MemoryStream();
XmlWriter writer = XmlWriter.Create(strm, settings);
writer.WriteElementString("orderID", "1-456-ab");
writer.WriteElementString("orderID", "2-36-00a");
writer.Flush();
writer.Close();
// Do additional processing on the stream.
Dim settings As XmlWriterSettings = New XmlWriterSettings()
settings.OmitXmlDeclaration = true
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.CloseOutput = false
' Create the XmlWriter object and write some content.
Dim strm as MemoryStream = new MemoryStream()
Dim writer As XmlWriter = XmlWriter.Create(strm, settings)
writer.WriteElementString("orderID", "1-456-ab")
writer.WriteElementString("orderID", "2-36-00a")
writer.Flush()
writer.Close()
' Do additional processing on the stream.
Комментарии
При использовании этой перегрузки XmlWriterSettings объект со следующими параметрами по умолчанию используется для создания модуля записи XML:
| Setting | По умолчанию |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Два пробела |
| NamespaceHandling | Default (без удаления) |
| NewLineChars |
\r\n (возврат каретки, канал строки) для платформ, отличных от Unix, или \n (канал строк) для платформ Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Если вы хотите указать функции для поддержки созданного модуля записи, используйте перегрузку, которая принимает XmlWriterSettings объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.
Кроме того, XmlWriter всегда записывает метку порядка байтов (BOM) в базовый поток данных; однако некоторые потоки не должны иметь BOM. Чтобы опустить BOM, создайте новый XmlWriterSettings объект и задайте для свойства Кодировки новый UTF8Encoding объект с логическим значением в конструкторе, равным false.
Применяется к
Create(XmlWriter)
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
- Исходный код:
- XmlWriter.cs
public:
static System::Xml::XmlWriter ^ Create(System::Xml::XmlWriter ^ output);
public static System.Xml.XmlWriter Create(System.Xml.XmlWriter output);
static member Create : System.Xml.XmlWriter -> System.Xml.XmlWriter
Public Shared Function Create (output As XmlWriter) As XmlWriter
Параметры
- output
- XmlWriter
Объект XmlWriter , который требуется использовать в качестве базового модуля записи.
Возвращаемое значение
Объект XmlWriter , который упакован вокруг указанного XmlWriter объекта.
Исключения
output равно null.
Комментарии
Этот метод позволяет добавлять функции в базовый XmlWriter объект. Базовый XmlWriter объект может быть объектом, созданным XmlWriter.Create методом, или объектом, созданным XmlTextWriter с помощью реализации.
При использовании этой перегрузки XmlWriterSettings объект с параметрами по умолчанию используется для создания модуля записи XML.
| Setting | По умолчанию |
|---|---|
| CheckCharacters | true |
| CloseOutput | false |
| ConformanceLevel | ConformanceLevel.Document |
| Encoding | Encoding.UTF8 |
| Indent | false |
| IndentChars | Два пробела |
| NamespaceHandling | Default (без удаления) |
| NewLineChars |
\r\n (возврат каретки, канал строки) для платформ, отличных от Unix, или \n (канал строк) для платформ Unix |
| NewLineHandling | NewLineHandling.Replace |
| NewLineOnAttributes | false |
| OmitXmlDeclaration | false |
| OutputMethod | XmlOutputMethod.Xml |
| WriteEndDocumentOnClose | true |
Если вы хотите указать функции для поддержки созданного модуля записи XML, используйте перегрузку, XmlWriterSettings принимающую объект в XmlWriterSettings качестве одного из его аргументов, и передайте объект с пользовательскими параметрами.