XmlWriter.Create Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Tworzy nowe wystąpienie klasy XmlWriter.

Przeciążenia

Create(StringBuilder, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu StringBuilder obiektów i XmlWriterSettings .
Create(String, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu nazwy pliku i XmlWriterSettings obiektu.
Create(TextWriter, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu TextWriter obiektów i XmlWriterSettings .
Create(Stream, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu strumienia i XmlWriterSettings obiektu.
Create(XmlWriter, XmlWriterSettings)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonych XmlWriter obiektów i XmlWriterSettings .
Create(StringBuilder)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego StringBuilderelementu .
Create(String)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonej nazwy pliku.
Create(TextWriter)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego TextWriterelementu .
Create(Stream)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego strumienia.
Create(XmlWriter)	Tworzy nowe XmlWriter wystąpienie przy użyciu określonego XmlWriter obiektu.

Uwagi

Create Niektóre przeciążenia obejmują settings parametr, który akceptuje XmlWriterSettings obiekt. Tego obiektu można użyć do:

• Określ, które funkcje mają być obsługiwane w utworzonym XmlWriter obiekcie.

• Użyj ponownie obiektu, XmlWriterSettings aby utworzyć wiele obiektów zapisywania. Obiekt XmlWriterSettings jest kopiowany i oznaczony jako tylko do odczytu dla każdego utworzonego składnika zapisywania. Zmiany ustawień w XmlWriterSettings wystąpieniu nie mają wpływu na istniejących składników zapisywania z tymi samymi ustawieniami. W związku z tym można użyć tych samych ustawień, aby utworzyć wiele składników zapisywania z tą samą funkcjonalnością. Możesz też zmodyfikować ustawienia wystąpienia XmlWriterSettings i utworzyć nowy moduł zapisywania z innym zestawem funkcji.

• Dodawanie funkcji do istniejącego składnika zapisywania XML. Metoda Create może akceptować inny XmlWriter obiekt. Obiekt źródłowy XmlWriter nie musi być modułem zapisywania XML utworzonym przez metodę statyczną Create . Można na przykład określić zdefiniowany przez użytkownika moduł zapisywania XML, aby dodać do programu dodatkowe funkcje.

• Pełne wykorzystanie funkcji, takich jak lepsze sprawdzanie zgodności i zgodność z zaleceniem XML 1.0 , które są dostępne tylko dla XmlWriter obiektów utworzonych przez metodę statyczną Create .

Jeśli używasz Create przeciążenia, które nie akceptuje XmlWriterSettings obiektu, zostaną użyte następujące domyślne ustawienia modułu zapisywania:

Ustawienie	Domyślny
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dwie spacje
NamespaceHandling	Default (brak usunięcia)
NewLineChars	\r\n (powrót karetki, nowy wiersz)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Uwaga

Mimo że .NET Framework zawiera klasęXmlTextWriter, która jest konkretną implementacją XmlWriter klasy, zalecamy utworzenie XmlWriter wystąpień przy użyciu Create metody .

Create(StringBuilder, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie przy użyciu StringBuilder obiektów i 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

Parametry

output

StringBuilder

Element StringBuilder , do którego ma być zapisywany. Zawartość napisana przez element XmlWriter jest dołączana do elementu StringBuilder.

settings

XmlWriterSettings

Obiekt XmlWriterSettings używany do konfigurowania nowego XmlWriter wystąpienia. Jeśli jest nullto wartość , zostanie użyta XmlWriterSettings wartość z ustawieniami domyślnymi.

XmlWriter Jeśli obiekt jest używany z Transform(String, XmlWriter) metodą , należy użyć OutputSettings właściwości , aby uzyskać XmlWriterSettings obiekt z poprawnymi ustawieniami. Gwarantuje to, że utworzony XmlWriter obiekt ma poprawne ustawienia danych wyjściowych.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu builder to null.

Create(String, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie przy użyciu nazwy pliku i XmlWriterSettings obiektu.

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

Parametry

outputFileName

String

Plik, do którego chcesz zapisać. Obiekt XmlWriter tworzy plik w określonej ścieżce i zapisuje go w składni tekstowej XML 1.0. Musi outputFileName być ścieżką systemu plików.

settings

XmlWriterSettings

Obiekt XmlWriterSettings używany do konfigurowania nowego XmlWriter wystąpienia. Jeśli jest nullto wartość , zostanie użyta XmlWriterSettings wartość z ustawieniami domyślnymi.

XmlWriter Jeśli obiekt jest używany z Transform(String, XmlWriter) metodą , należy użyć OutputSettings właściwości , aby uzyskać XmlWriterSettings obiekt z poprawnymi ustawieniami. Gwarantuje to, że utworzony XmlWriter obiekt ma poprawne ustawienia danych wyjściowych.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu url to null.

Przykłady

Poniższy przykład tworzy XmlWriter obiekt ze zdefiniowanymi ustawieniami.

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)

Tworzy nowe XmlWriter wystąpienie przy użyciu TextWriter obiektów i 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

Parametry

output

TextWriter

Element TextWriter , do którego chcesz napisać. Kod XmlWriter XML 1.0 zapisuje składnię tekstu i dołącza ją do określonego TextWriterelementu .

settings

XmlWriterSettings

Obiekt XmlWriterSettings używany do konfigurowania nowego XmlWriter wystąpienia. Jeśli jest nullto wartość , zostanie użyta XmlWriterSettings wartość z ustawieniami domyślnymi.

XmlWriter Jeśli obiekt jest używany z Transform(String, XmlWriter) metodą , należy użyć OutputSettings właściwości , aby uzyskać XmlWriterSettings obiekt z poprawnymi ustawieniami. Gwarantuje to, że utworzony XmlWriter obiekt ma poprawne ustawienia danych wyjściowych.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu text to null.

Przykłady

Poniższy przykład zapisuje ciąg 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)

Tworzy nowe XmlWriter wystąpienie przy użyciu strumienia i XmlWriterSettings obiektu.

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

Parametry

output

Stream

Strumień, do którego chcesz napisać. Kod XmlWriter XML 1.0 zapisuje składnię tekstu i dołącza ją do określonego strumienia.

settings

XmlWriterSettings

Obiekt XmlWriterSettings używany do konfigurowania nowego XmlWriter wystąpienia. Jeśli jest nullto wartość , zostanie użyta XmlWriterSettings wartość z ustawieniami domyślnymi.

XmlWriter Jeśli obiekt jest używany z Transform(String, XmlWriter) metodą , należy użyć OutputSettings właściwości , aby uzyskać XmlWriterSettings obiekt z poprawnymi ustawieniami. Gwarantuje to, że utworzony XmlWriter obiekt ma poprawne ustawienia danych wyjściowych.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu stream to null.

Przykłady

Poniższy przykład zapisuje fragment XML w strumieniu pamięci.

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.

Uwagi

XmlWriter zawsze zapisuje znak zamówienia bajtów (BOM) do bazowego strumienia danych; jednak niektóre strumienie nie mogą mieć modelu BOM. Aby pominąć model BOM, utwórz nowy XmlWriterSettings obiekt i ustaw właściwość Encoding na nowy UTF8Encoding obiekt z wartością logiczną w konstruktorze ustawionym na wartość false.

Create(XmlWriter, XmlWriterSettings)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonych XmlWriter obiektów i 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

Parametry

output

XmlWriter

XmlWriter Obiekt, którego chcesz użyć jako bazowego składnika zapisywania.

settings

XmlWriterSettings

Obiekt XmlWriterSettings używany do konfigurowania nowego XmlWriter wystąpienia. Jeśli jest nullto wartość , zostanie użyta XmlWriterSettings wartość z ustawieniami domyślnymi.

XmlWriter Jeśli obiekt jest używany z Transform(String, XmlWriter) metodą , należy użyć OutputSettings właściwości , aby uzyskać XmlWriterSettings obiekt z poprawnymi ustawieniami. Gwarantuje to, że utworzony XmlWriter obiekt ma poprawne ustawienia danych wyjściowych.

Zwraca

XmlWriter

Obiekt XmlWriter , który jest owinięty wokół określonego XmlWriter obiektu.

Wyjątki

ArgumentNullException

Wartość elementu writer to null.

Uwagi

Ta metoda umożliwia dodawanie dodatkowych funkcji do obiektu bazowego XmlWriter . Obiektem bazowym XmlWriter może być obiekt utworzony przez metodę XmlWriter.Create lub obiekt utworzony przy użyciu implementacji XmlTextWriter .

Create(StringBuilder)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego StringBuilderelementu .

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

Parametry

output

StringBuilder

Element StringBuilder , do którego ma być zapisywany. Zawartość napisana przez element XmlWriter jest dołączana do elementu StringBuilder.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu builder to null.

Uwagi

W przypadku użycia tego przeciążenia XmlWriterSettings obiekt z ustawieniami domyślnymi jest używany do tworzenia składnika zapisywania XML.

Ustawienie	Domyślny
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dwie spacje
NamespaceHandling	Default (brak usunięcia)
NewLineChars	\r\n (powrót karetki, nowy wiersz)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jeśli chcesz określić funkcje do obsługi w utworzonym składniku zapisywania XML, użyj przeciążenia, które przyjmuje XmlWriterSettings obiekt jako jeden z jego argumentów i przekaż XmlWriterSettings obiekt z ustawieniami niestandardowymi.

Create(String)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonej nazwy pliku.

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

Parametry

outputFileName

String

Plik, do którego chcesz zapisać. Obiekt XmlWriter tworzy plik w określonej ścieżce i zapisuje go w składni tekstowej XML 1.0. Musi outputFileName być ścieżką systemu plików.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu url to null.

Przykłady

Poniższy przykład tworzy XmlWriter obiekt i zapisuje węzeł książki.

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

Uwagi

W przypadku użycia tego przeciążenia XmlWriterSettings obiekt z ustawieniami domyślnymi jest używany do tworzenia składnika zapisywania XML.

Ustawienie	Domyślny
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dwie spacje
NamespaceHandling	Default (brak usunięcia)
NewLineChars	\r\n (powrót karetki, nowy wiersz)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jeśli chcesz określić funkcje do obsługi w utworzonym składniku zapisywania XML, użyj przeciążenia, które przyjmuje XmlWriterSettings obiekt jako jeden z jego argumentów i przekaż XmlWriterSettings obiekt z ustawieniami niestandardowymi.

Create(TextWriter)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego TextWriterelementu .

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

Parametry

output

TextWriter

Element TextWriter , do którego chcesz napisać. Kod XmlWriter XML 1.0 zapisuje składnię tekstu i dołącza ją do określonego TextWriterelementu .

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu text to null.

Przykłady

Poniższy przykład tworzy moduł zapisywania, który zwraca dane wyjściowe do konsoli.

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

Uwagi

W przypadku użycia tego przeciążenia XmlWriterSettings obiekt z ustawieniami domyślnymi jest używany do tworzenia składnika zapisywania XML.

Ustawienie	Domyślny
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dwie spacje
NamespaceHandling	Default (brak usunięcia)
NewLineChars	\r\n (powrót karetki, nowy wiersz)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jeśli chcesz określić funkcje do obsługi w utworzonym składniku zapisywania, użyj przeciążenia, które przyjmuje XmlWriterSettings obiekt jako jeden z jego argumentów i przekaż XmlWriterSettings obiekt z ustawieniami niestandardowymi.

Create(Stream)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego strumienia.

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

Parametry

output

Stream

Strumień, do którego chcesz napisać. Kod XmlWriter XML 1.0 zapisuje składnię tekstu i dołącza ją do określonego strumienia.

Zwraca

XmlWriter

Obiekt XmlWriter.

Wyjątki

ArgumentNullException

Wartość elementu stream to null.

Przykłady

Poniższy przykład zapisuje fragment XML w strumieniu pamięci. (Używa Create(Stream, XmlWriterSettings) przeciążenia, które konfiguruje również ustawienia w nowym wystąpieniu modułu zapisywania 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.

Uwagi

W przypadku użycia tego przeciążenia XmlWriterSettings obiekt z następującymi ustawieniami domyślnymi jest używany do tworzenia składnika zapisywania XML:

Ustawienie	Domyślny
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dwie spacje
NamespaceHandling	Default (brak usunięcia)
NewLineChars	\r\n (powrót karetki, nowy wiersz)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jeśli chcesz określić funkcje do obsługi w utworzonym składniku zapisywania, użyj przeciążenia, które przyjmuje XmlWriterSettings obiekt jako jeden z jego argumentów i przekaż XmlWriterSettings obiekt z ustawieniami niestandardowymi.

Ponadto funkcja XmlWriter zawsze zapisuje znacznik kolejności bajtów (BOM) do bazowego strumienia danych; jednak niektóre strumienie nie mogą mieć modelu BOM. Aby pominąć model BOM, utwórz nowy XmlWriterSettings obiekt i ustaw właściwość Encoding na nowy UTF8Encoding obiekt z wartością logiczną w konstruktorze ustawionym na wartość false.

Create(XmlWriter)

Tworzy nowe XmlWriter wystąpienie przy użyciu określonego XmlWriter obiektu.

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

Parametry

output

XmlWriter

XmlWriter Obiekt, którego chcesz użyć jako bazowego składnika zapisywania.

Zwraca

XmlWriter

Obiekt XmlWriter , który jest owinięty wokół określonego XmlWriter obiektu.

Wyjątki

ArgumentNullException

Wartość elementu writer to null.

Uwagi

Ta metoda umożliwia dodawanie funkcji do obiektu bazowego XmlWriter . Obiektem bazowym XmlWriter może być obiekt utworzony przez metodę XmlWriter.Create lub obiekt utworzony przy użyciu implementacji XmlTextWriter .

W przypadku użycia tego przeciążenia XmlWriterSettings obiekt z ustawieniami domyślnymi jest używany do tworzenia składnika zapisywania XML.

Ustawienie	Domyślny
CheckCharacters	true
CloseOutput	false
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	false
IndentChars	Dwie spacje
NamespaceHandling	Default (brak usunięcia)
NewLineChars	\r\n (powrót karetki, nowy wiersz)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Jeśli chcesz określić funkcje do obsługi w utworzonym składniku zapisywania XML, użyj przeciążenia, które przyjmuje XmlWriterSettings obiekt jako jeden z jego argumentów i przekaż XmlWriterSettings obiekt z ustawieniami niestandardowymi.