XmlWriter.Create Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: System.Xml.dll, System.Xml.ReaderWriter.dll

Sammansättningar:: netstandard.dll, System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en ny XmlWriter instans.

Överlagringar

Name	Description
Create(StringBuilder, XmlWriterSettings)	Skapar en ny XmlWriter instans med hjälp av objekten StringBuilder och XmlWriterSettings .
Create(String, XmlWriterSettings)	Skapar en ny XmlWriter instans med filnamnet och XmlWriterSettings objektet.
Create(TextWriter, XmlWriterSettings)	Skapar en ny XmlWriter instans med hjälp av objekten TextWriter och XmlWriterSettings .
Create(Stream, XmlWriterSettings)	Skapar en ny XmlWriter instans med hjälp av strömmen och XmlWriterSettings objektet.
Create(XmlWriter, XmlWriterSettings)	Skapar en ny XmlWriter instans med hjälp av angivna XmlWriter objekt och XmlWriterSettings objekt.
Create(StringBuilder)	Skapar en ny XmlWriter instans med den angivna StringBuilder.
Create(String)	Skapar en ny XmlWriter instans med det angivna filnamnet.
Create(TextWriter)	Skapar en ny XmlWriter instans med den angivna TextWriter.
Create(Stream)	Skapar en ny XmlWriter instans med den angivna strömmen.
Create(XmlWriter)	Skapar en ny XmlWriter instans med det angivna XmlWriter objektet.

Kommentarer

Några av överlagringarna Create innehåller en settings parameter som accepterar ett XmlWriterSettings objekt. Du kan använda det här objektet för att:

Ange vilka funktioner som ska stödjas på det skapade XmlWriter objektet.
Återanvänd objektet XmlWriterSettings för att skapa flera skrivobjekt. Objektet XmlWriterSettings kopieras och markeras som skrivskyddat för varje skapad skrivare. Ändringar i inställningarna på en XmlWriterSettings instans påverkar inte befintliga skrivare med samma inställningar. Därför kan du använda samma inställningar för att skapa flera skrivare med samma funktioner. Eller så kan du ändra inställningarna på en XmlWriterSettings instans och skapa en ny skrivare med en annan uppsättning funktioner.
Lägg till funktioner i en befintlig XML-skrivare. Metoden Create kan acceptera ett annat XmlWriter objekt. Det underliggande XmlWriter objektet behöver inte vara en XML-skrivare som skapats av den statiska Create metoden. Du kan till exempel ange en användardefinierad XML-skrivare för att lägga till ytterligare funktioner i.
Dra full nytta av funktioner som bättre efterlevnadskontroll och efterlevnad av XML 1.0-rekommendationen som endast är tillgängliga för XmlWriter objekt som skapats av den statiska Create metoden.

Om du använder en Create överlagring som inte accepterar ett XmlWriterSettings objekt används följande standardinställningar för skrivskydd:

Inställningen	Standardinställning
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Två blanksteg
NamespaceHandling	Default (ingen borttagning)
NewLineChars	`\r\n` (vagnretur, linjematning) för icke-Unix-plattformar eller `\n` (linjematning) för Unix-plattformar
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Note

Även om .NET Framework innehåller klassen XmlTextWriter, vilket är en konkret implementering av klassen XmlWriter, rekommenderar vi att du skapar XmlWriter-instanser med hjälp av metoden Create.

Create(StringBuilder, XmlWriterSettings)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med hjälp av objekten StringBuilder och 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

Parametrar

output: StringBuilder

Till StringBuilder vilken du ska skriva till. Innehållet som XmlWriter skrivs av läggs till i StringBuilder.

settings: XmlWriterSettings

Objektet XmlWriterSettings som används för att konfigurera den nya XmlWriter instansen. Om detta är nullanvänds en XmlWriterSettings med standardinställningar.

XmlWriter Om används med Transform(String, XmlWriter) metoden bör du använda OutputSettings egenskapen för att hämta ett XmlWriterSettings objekt med rätt inställningar. Detta säkerställer att det skapade XmlWriter objektet har rätt utdatainställningar.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

output är null.

Gäller för

Create(String, XmlWriterSettings)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med filnamnet och XmlWriterSettings objektet.

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

Parametrar

outputFileName: String

Filen som du vill skriva till. XmlWriter Skapar en fil på den angivna sökvägen och skriver till den i XML 1.0-textsyntax. Måste outputFileName vara en filsystemsökväg.

settings: XmlWriterSettings

Objektet XmlWriterSettings som används för att konfigurera den nya XmlWriter instansen. Om detta är nullanvänds en XmlWriterSettings med standardinställningar.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

outputFileName är null.

Exempel

I följande exempel skapas ett XmlWriter objekt med de definierade inställningarna.

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

Gäller för

Create(TextWriter, XmlWriterSettings)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med hjälp av objekten TextWriter och 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

Parametrar

output: TextWriter

Den TextWriter som du vill skriva till. Textsyntaxen XmlWriter för xml 1.0 skrivs och läggs till i den angivna TextWriter.

settings: XmlWriterSettings

Objektet XmlWriterSettings som används för att konfigurera den nya XmlWriter instansen. Om detta är nullanvänds en XmlWriterSettings med standardinställningar.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

output är null.

Exempel

I följande exempel skrivs ut en XML-sträng.

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

Gäller för

Create(Stream, XmlWriterSettings)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med hjälp av strömmen och XmlWriterSettings objektet.

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

Parametrar

output: Stream

Den ström som du vill skriva till. Textsyntaxen XmlWriter skriver XML 1.0 och lägger till den i den angivna strömmen.

settings: XmlWriterSettings

Objektet XmlWriterSettings som används för att konfigurera den nya XmlWriter instansen. Om detta är nullanvänds en XmlWriterSettings med standardinställningar.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

output är null.

Exempel

I följande exempel skrivs ett XML-fragment till en minnesström.

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.

Kommentarer

XmlWriter skriver alltid en Byte Order Mark (BOM) till den underliggande dataströmmen. Vissa strömmar får dock inte ha någon strukturlista. Om du vill utelämna strukturlistan skapar du ett nytt XmlWriterSettings objekt och anger att kodningsegenskapen ska vara ett nytt UTF8Encoding objekt med det booleska värdet i konstruktorn inställt på false.

Gäller för

Create(XmlWriter, XmlWriterSettings)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med hjälp av angivna XmlWriter objekt och 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

Parametrar

output: XmlWriter

Det XmlWriter objekt som du vill använda som underliggande skrivare.

settings: XmlWriterSettings

Objektet XmlWriterSettings som används för att konfigurera den nya XmlWriter instansen. Om detta är nullanvänds en XmlWriterSettings med standardinställningar.

Returer

XmlWriter

Ett XmlWriter objekt som omsluts av det angivna XmlWriter objektet.

Undantag

ArgumentNullException

output är null.

Kommentarer

Med den här metoden kan du lägga till ytterligare funktioner i ett underliggande XmlWriter objekt. Det underliggande XmlWriter objektet kan vara ett objekt som skapats av XmlWriter.Create metoden eller ett objekt som skapats med implementeringen XmlTextWriter .

Gäller för

Create(StringBuilder)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med den angivna 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

Parametrar

output: StringBuilder

Till StringBuilder vilken du ska skriva till. Innehållet som XmlWriter skrivs av läggs till i StringBuilder.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

output är null.

Kommentarer

När du använder den här överlagringen används ett XmlWriterSettings objekt med standardinställningar för att skapa XML-skrivaren.

Inställningen	Standardinställning
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Två blanksteg
NamespaceHandling	Default (ingen borttagning)
NewLineChars	`\r\n` (vagnretur, linjematning) för icke-Unix-plattformar eller `\n` (linjematning) för Unix-plattformar
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Om du vill ange vilka funktioner som ska stödjas på den skapade XML-skrivaren använder du en överlagring som tar ett XmlWriterSettings objekt som ett av argumenten och skickar in ett XmlWriterSettings objekt med dina anpassade inställningar.

Gäller för

Create(String)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med det angivna filnamnet.

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

Parametrar

outputFileName: String

Filen som du vill skriva till. XmlWriter Skapar en fil på den angivna sökvägen och skriver till den i XML 1.0-textsyntax. Måste outputFileName vara en filsystemsökväg.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

outputFileName är null.

Exempel

I följande exempel skapas ett XmlWriter objekt och en boknod skrivs.

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

Kommentarer

När du använder den här överlagringen används ett XmlWriterSettings objekt med standardinställningar för att skapa XML-skrivaren.

Inställningen	Standardinställning
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Två blanksteg
NamespaceHandling	Default (ingen borttagning)
NewLineChars	`\r\n` (vagnretur, linjematning) för icke-Unix-plattformar eller `\n` (linjematning) för Unix-plattformar
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Gäller för

Create(TextWriter)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med den angivna 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

Parametrar

output: TextWriter

Den TextWriter som du vill skriva till. Textsyntaxen XmlWriter för xml 1.0 skrivs och läggs till i den angivna TextWriter.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

output är null.

Exempel

I följande exempel skapas en skrivare som matar ut till konsolen.

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

Kommentarer

När du använder den här överlagringen används ett XmlWriterSettings objekt med standardinställningar för att skapa XML-skrivaren.

Inställningen	Standardinställning
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Två blanksteg
NamespaceHandling	Default (ingen borttagning)
NewLineChars	`\r\n` (vagnretur, linjematning) för icke-Unix-plattformar eller `\n` (linjematning) för Unix-plattformar
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Om du vill ange vilka funktioner som ska stödjas på den skapade skrivaren använder du en överlagring som tar ett XmlWriterSettings objekt som ett av dess argument och skickar in ett XmlWriterSettings objekt med dina anpassade inställningar.

Gäller för

Create(Stream)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med den angivna strömmen.

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

Parametrar

output: Stream

Den ström som du vill skriva till. Textsyntaxen XmlWriter skriver XML 1.0 och lägger till den i den angivna strömmen.

Returer

XmlWriter

Ett XmlWriter objekt.

Undantag

ArgumentNullException

output är null.

Exempel

I följande exempel skrivs ett XML-fragment till en minnesström. (Den använder överbelastningen Create(Stream, XmlWriterSettings) , som även konfigurerar inställningarna för den nya XML-skrivinstansen.)

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.

Kommentarer

När du använder den här överlagringen används ett XmlWriterSettings objekt med följande standardinställningar för att skapa XML-skrivaren:

Inställningen	Standardinställning
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Två blanksteg
NamespaceHandling	Default (ingen borttagning)
NewLineChars	`\r\n` (vagnretur, linjematning) för icke-Unix-plattformar eller `\n` (linjematning) för Unix-plattformar
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Dessutom skriver XmlWriter alltid en bom (Byte Order Mark) till den underliggande dataströmmen. Vissa strömmar får dock inte ha någon strukturlista. Om du vill utelämna strukturlistan skapar du ett nytt XmlWriterSettings objekt och anger att kodningsegenskapen ska vara ett nytt UTF8Encoding objekt med det booleska värdet i konstruktorn inställt på false.

Gäller för

Create(XmlWriter)

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Källa:: XmlWriter.cs

Skapar en ny XmlWriter instans med det angivna XmlWriter objektet.

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

Parametrar

output: XmlWriter

Det XmlWriter objekt som du vill använda som underliggande skrivare.

Returer

XmlWriter

Ett XmlWriter objekt som omsluts av det angivna XmlWriter objektet.

Undantag

ArgumentNullException

output är null.

Kommentarer

Med den här metoden kan du lägga till funktioner i ett underliggande XmlWriter objekt. Det underliggande XmlWriter objektet kan vara ett objekt som skapats av XmlWriter.Create metoden eller ett objekt som skapats med implementeringen XmlTextWriter .

När du använder den här överlagringen används ett XmlWriterSettings objekt med standardinställningar för att skapa XML-skrivaren.

Inställningen	Standardinställning
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	Två blanksteg
NamespaceHandling	Default (ingen borttagning)
NewLineChars	`\r\n` (vagnretur, linjematning) för icke-Unix-plattformar eller `\n` (linjematning) för Unix-plattformar
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Gäller för

Feedback

Var den här sidan till hjälp?