XmlWriter.Create Metoda

Definice

Vytvoří novou instanci XmlWriter.

Přetížení

Name Description
Create(StringBuilder, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí StringBuilder objektů a XmlWriterSettings objektů.

Create(String, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí názvu souboru a XmlWriterSettings objektu.

Create(TextWriter, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí TextWriter objektů a XmlWriterSettings objektů.

Create(Stream, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí datového proudu a XmlWriterSettings objektu.

Create(XmlWriter, XmlWriterSettings)

Vytvoří novou XmlWriter instanci pomocí zadaných XmlWriter objektů a XmlWriterSettings objektů.

Create(StringBuilder)

Vytvoří novou XmlWriter instanci pomocí zadaného StringBuilder.

Create(String)

Vytvoří novou XmlWriter instanci pomocí zadaného názvu souboru.

Create(TextWriter)

Vytvoří novou XmlWriter instanci pomocí zadaného TextWriter.

Create(Stream)

Vytvoří novou XmlWriter instanci pomocí zadaného datového proudu.

Create(XmlWriter)

Vytvoří novou XmlWriter instanci pomocí zadaného XmlWriter objektu.

Poznámky

Některé přetížení Create zahrnují settings parametr, který přijímá XmlWriterSettings objekt. Tento objekt můžete použít k:

  • Určete, které funkce chcete u vytvořeného XmlWriter objektu podporovat.

  • Znovu použijte XmlWriterSettings objekt k vytvoření více objektů zapisovače. Objekt XmlWriterSettings se zkopíruje a označí jako jen pro čtení pro každý vytvořený zapisovač. Změny nastavení v XmlWriterSettings instanci nemají vliv na existující zapisovače se stejným nastavením. Stejná nastavení tedy můžete použít k vytvoření více zapisovačů se stejnou funkcí. Nebo můžete upravit nastavení XmlWriterSettings instance a vytvořit nový zapisovač s jinou sadou funkcí.

  • Přidání funkcí do existujícího zapisovače XML Metoda Create může přijmout jiný XmlWriter objekt. Základní XmlWriter objekt nemusí být zapisovačem XML vytvořeným statickou Create metodou. Můžete například zadat zapisovač XML definovaný uživatelem, do které chcete přidat další funkce.

  • Využijte úplné výhody funkcí, jako je lepší kontrola shody a dodržování předpisů s doporučením XML 1.0 , které jsou k dispozici pouze u XmlWriter objektů vytvořených statickou Create metodou.

Pokud použijete Create přetížení, které objekt nepřijímá XmlWriterSettings , použijí se následující výchozí nastavení zapisovače:

Setting Výchozí
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dvě mezery
NamespaceHandling Default (bez odebrání)
NewLineChars \r\n (návrat na začátek řádku, odřádkování) pro platformy bez unixu nebo \n (podávání čar) pro platformy Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Note

Přestože .NET Framework zahrnuje třídu XmlTextWriter, což je konkrétní implementace třídy XmlWriter, doporučujeme vytvořit instance XmlWriter pomocí metody Create.

Create(StringBuilder, XmlWriterSettings)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí StringBuilder objektů a XmlWriterSettings objektů.

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

Do StringBuilder kterého se má zapisovat. Obsah napsaný řetězcem XmlWriter je připojen k objektu StringBuilder.

settings
XmlWriterSettings

Objekt XmlWriterSettings použitý ke konfiguraci nové XmlWriter instance. Pokud ano null, použije se XmlWriterSettings výchozí nastavení.

XmlWriter Pokud se používá s metodouTransform(String, XmlWriter), měli byste použít OutputSettings vlastnost k získání objektu XmlWriterSettings se správným nastavením. Tím zajistíte, že vytvořený XmlWriter objekt má správné nastavení výstupu.

Návraty

Objekt XmlWriter.

Výjimky

output je null.

Platí pro

Create(String, XmlWriterSettings)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí názvu souboru a XmlWriterSettings objektu.

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

Soubor, do kterého chcete zapisovat. Vytvoří XmlWriter soubor v zadané cestě a zapíše ho do textové syntaxe XML 1.0. Musí outputFileName to být cesta k systému souborů.

settings
XmlWriterSettings

Objekt XmlWriterSettings použitý ke konfiguraci nové XmlWriter instance. Pokud ano null, použije se XmlWriterSettings výchozí nastavení.

XmlWriter Pokud se používá s metodouTransform(String, XmlWriter), měli byste použít OutputSettings vlastnost k získání objektu XmlWriterSettings se správným nastavením. Tím zajistíte, že vytvořený XmlWriter objekt má správné nastavení výstupu.

Návraty

Objekt XmlWriter.

Výjimky

outputFileName je null.

Příklady

Následující příklad vytvoří XmlWriter objekt s definovaným nastavením.

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

Platí pro

Create(TextWriter, XmlWriterSettings)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí TextWriter objektů a XmlWriterSettings objektů.

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

Do TextWriter kterého chcete psát. Zapíše XmlWriter syntaxi textu XML 1.0 a připojí ji k zadanému TextWriter.

settings
XmlWriterSettings

Objekt XmlWriterSettings použitý ke konfiguraci nové XmlWriter instance. Pokud ano null, použije se XmlWriterSettings výchozí nastavení.

XmlWriter Pokud se používá s metodouTransform(String, XmlWriter), měli byste použít OutputSettings vlastnost k získání objektu XmlWriterSettings se správným nastavením. Tím zajistíte, že vytvořený XmlWriter objekt má správné nastavení výstupu.

Návraty

Objekt XmlWriter.

Výjimky

output je null.

Příklady

Následující příklad zapíše řetězec 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

Platí pro

Create(Stream, XmlWriterSettings)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí datového proudu a XmlWriterSettings objektu.

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

Datový proud, do kterého chcete psát. Zapíše XmlWriter syntaxi textu XML 1.0 a připojí ji k zadanému datovému proudu.

settings
XmlWriterSettings

Objekt XmlWriterSettings použitý ke konfiguraci nové XmlWriter instance. Pokud ano null, použije se XmlWriterSettings výchozí nastavení.

XmlWriter Pokud se používá s metodouTransform(String, XmlWriter), měli byste použít OutputSettings vlastnost k získání objektu XmlWriterSettings se správným nastavením. Tím zajistíte, že vytvořený XmlWriter objekt má správné nastavení výstupu.

Návraty

Objekt XmlWriter.

Výjimky

output je null.

Příklady

Následující příklad zapíše fragment XML do datového proudu paměti.

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.

Poznámky

XmlWriter vždy zapíše značku pořadí bajtů (BOM) do podkladového datového proudu; Některé datové proudy ale nesmí obsahovat kusovník. Chcete-li vynechat boM, vytvořte nový XmlWriterSettings objekt a nastavte Vlastnost Encoding na nový UTF8Encoding objekt s logickou hodnotou v konstruktoru nastavenou na false.

Platí pro

Create(XmlWriter, XmlWriterSettings)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí zadaných XmlWriter objektů a XmlWriterSettings objektů.

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

Objekt XmlWriter , který chcete použít jako podkladový zapisovač.

settings
XmlWriterSettings

Objekt XmlWriterSettings použitý ke konfiguraci nové XmlWriter instance. Pokud ano null, použije se XmlWriterSettings výchozí nastavení.

XmlWriter Pokud se používá s metodouTransform(String, XmlWriter), měli byste použít OutputSettings vlastnost k získání objektu XmlWriterSettings se správným nastavením. Tím zajistíte, že vytvořený XmlWriter objekt má správné nastavení výstupu.

Návraty

Objekt XmlWriter , který je zabalen kolem zadaného XmlWriter objektu.

Výjimky

output je null.

Poznámky

Tato metoda umožňuje přidat další funkce do podkladového XmlWriter objektu. Podkladový XmlWriter objekt může být objekt vytvořený metodou XmlWriter.Create nebo objekt vytvořený pomocí XmlTextWriter implementace.

Platí pro

Create(StringBuilder)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí zadaného 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

Parametry

output
StringBuilder

Do StringBuilder kterého se má zapisovat. Obsah napsaný řetězcem XmlWriter je připojen k objektu StringBuilder.

Návraty

Objekt XmlWriter.

Výjimky

output je null.

Poznámky

Při použití tohoto přetížení XmlWriterSettings se objekt s výchozím nastavením použije k vytvoření zapisovače XML.

Setting Výchozí
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dvě mezery
NamespaceHandling Default (bez odebrání)
NewLineChars \r\n (návrat na začátek řádku, odřádkování) pro platformy bez unixu nebo \n (podávání čar) pro platformy Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Pokud chcete určit funkce, které mají být podporovány u vytvořeného zapisovače XML, použijte přetížení, které přebírá XmlWriterSettings objekt jako jeden z jeho argumentů, a předejte XmlWriterSettings objekt s vlastním nastavením.

Platí pro

Create(String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí zadaného názvu souboru.

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

Soubor, do kterého chcete zapisovat. Vytvoří XmlWriter soubor v zadané cestě a zapíše ho do textové syntaxe XML 1.0. Musí outputFileName to být cesta k systému souborů.

Návraty

Objekt XmlWriter.

Výjimky

outputFileName je null.

Příklady

Následující příklad vytvoří XmlWriter objekt a zapíše uzel knihy.

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

Poznámky

Při použití tohoto přetížení XmlWriterSettings se objekt s výchozím nastavením použije k vytvoření zapisovače XML.

Setting Výchozí
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dvě mezery
NamespaceHandling Default (bez odebrání)
NewLineChars \r\n (návrat na začátek řádku, odřádkování) pro platformy bez unixu nebo \n (podávání čar) pro platformy Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Pokud chcete určit funkce, které mají být podporovány u vytvořeného zapisovače XML, použijte přetížení, které přebírá XmlWriterSettings objekt jako jeden z jeho argumentů, a předejte XmlWriterSettings objekt s vlastním nastavením.

Platí pro

Create(TextWriter)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí zadaného 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

Parametry

output
TextWriter

Do TextWriter kterého chcete psát. Zapíše XmlWriter syntaxi textu XML 1.0 a připojí ji k zadanému TextWriter.

Návraty

Objekt XmlWriter.

Výjimky

output je null.

Příklady

Následující příklad vytvoří zapisovač, který vypíše výstup do konzoly.

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

Poznámky

Při použití tohoto přetížení XmlWriterSettings se objekt s výchozím nastavením použije k vytvoření zapisovače XML.

Setting Výchozí
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dvě mezery
NamespaceHandling Default (bez odebrání)
NewLineChars \r\n (návrat na začátek řádku, odřádkování) pro platformy bez unixu nebo \n (podávání čar) pro platformy Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Pokud chcete určit funkce, které mají být podporovány u vytvořeného zapisovače, použijte přetížení, které přebírá XmlWriterSettings objekt jako jeden z jeho argumentů, a předejte XmlWriterSettings objekt s vlastním nastavením.

Platí pro

Create(Stream)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí zadaného datového proudu.

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

Datový proud, do kterého chcete psát. Zapíše XmlWriter syntaxi textu XML 1.0 a připojí ji k zadanému datovému proudu.

Návraty

Objekt XmlWriter.

Výjimky

output je null.

Příklady

Následující příklad zapíše fragment XML do datového proudu paměti. (Používá Create(Stream, XmlWriterSettings) přetížení, které také konfiguruje nastavení pro novou instanci zapisovače 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.

Poznámky

Při použití tohoto přetížení se XmlWriterSettings objekt s následujícím výchozím nastavením použije k vytvoření zapisovače XML:

Setting Výchozí
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dvě mezery
NamespaceHandling Default (bez odebrání)
NewLineChars \r\n (návrat na začátek řádku, odřádkování) pro platformy bez unixu nebo \n (podávání čar) pro platformy Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Pokud chcete určit funkce, které mají být podporovány u vytvořeného zapisovače, použijte přetížení, které přebírá XmlWriterSettings objekt jako jeden z jeho argumentů, a předejte XmlWriterSettings objekt s vlastním nastavením.

XmlWriter také vždy zapisuje znak pořadí bajtů (BOM) do podkladového datového proudu; Některé datové proudy ale nesmí obsahovat kusovník. Chcete-li vynechat boM, vytvořte nový XmlWriterSettings objekt a nastavte Vlastnost Encoding na nový UTF8Encoding objekt s logickou hodnotou v konstruktoru nastavenou na false.

Platí pro

Create(XmlWriter)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Vytvoří novou XmlWriter instanci pomocí zadaného XmlWriter objektu.

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

Objekt XmlWriter , který chcete použít jako podkladový zapisovač.

Návraty

Objekt XmlWriter , který je zabalen kolem zadaného XmlWriter objektu.

Výjimky

output je null.

Poznámky

Tato metoda umožňuje přidat funkce do podkladového XmlWriter objektu. Podkladový XmlWriter objekt může být objekt vytvořený metodou XmlWriter.Create nebo objekt vytvořený pomocí XmlTextWriter implementace.

Při použití tohoto přetížení XmlWriterSettings se objekt s výchozím nastavením použije k vytvoření zapisovače XML.

Setting Výchozí
CheckCharacters true
CloseOutput false
ConformanceLevel ConformanceLevel.Document
Encoding Encoding.UTF8
Indent false
IndentChars Dvě mezery
NamespaceHandling Default (bez odebrání)
NewLineChars \r\n (návrat na začátek řádku, odřádkování) pro platformy bez unixu nebo \n (podávání čar) pro platformy Unix
NewLineHandling NewLineHandling.Replace
NewLineOnAttributes false
OmitXmlDeclaration false
OutputMethod XmlOutputMethod.Xml
WriteEndDocumentOnClose true

Pokud chcete určit funkce, které mají být podporovány u vytvořeného zapisovače XML, použijte přetížení, které přebírá XmlWriterSettings objekt jako jeden z jeho argumentů, a předejte XmlWriterSettings objekt s vlastním nastavením.

Platí pro