XmlWriter.Create Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Yeni bir XmlWriter örneği oluşturur.

Aşırı Yüklemeler

Create(StringBuilder, XmlWriterSettings)	ve XmlWriterSettings nesnelerini kullanarak StringBuilder yeni XmlWriter bir örnek oluşturur.
Create(String, XmlWriterSettings)	dosya adını ve XmlWriterSettings nesnesini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(TextWriter, XmlWriterSettings)	ve XmlWriterSettings nesnelerini kullanarak TextWriter yeni XmlWriter bir örnek oluşturur.
Create(Stream, XmlWriterSettings)	Akışı ve XmlWriterSettings nesneyi kullanarak yeni XmlWriter bir örnek oluşturur.
Create(XmlWriter, XmlWriterSettings)	Belirtilen XmlWriter ve XmlWriterSettings nesnelerini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(StringBuilder)	Belirtilen StringBuilderöğesini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(String)	Belirtilen dosya adını kullanarak yeni XmlWriter bir örnek oluşturur.
Create(TextWriter)	Belirtilen TextWriteröğesini kullanarak yeni XmlWriter bir örnek oluşturur.
Create(Stream)	Belirtilen akışı kullanarak yeni XmlWriter bir örnek oluşturur.
Create(XmlWriter)	Belirtilen XmlWriter nesneyi kullanarak yeni XmlWriter bir örnek oluşturur.

Açıklamalar

Create Bazı aşırı yüklemeler, bir nesneyi kabul eden bir settings XmlWriterSettings parametre içerir. Bu nesneyi kullanarak şunları yapabilirsiniz:

Oluşturulan XmlWriter nesnede hangi özelliklerin destekleneceğini belirtin.
XmlWriterSettings Birden çok yazıcı nesnesi oluşturmak için nesnesini yeniden kullanma. Nesne XmlWriterSettings kopyalanır ve oluşturulan her yazıcı için salt okunur olarak işaretlenir. Bir XmlWriterSettings örnekteki ayarlarda yapılan değişiklikler, aynı ayarlara sahip mevcut yazıcıları etkilemez. Bu nedenle, aynı işlevlere sahip birden çok yazıcı oluşturmak için aynı ayarları kullanabilirsiniz. Alternatif olarak, bir XmlWriterSettings örnekteki ayarları değiştirebilir ve farklı özelliklere sahip yeni bir yazıcı oluşturabilirsiniz.
Varolan bir XML yazıcısına özellikler ekleyin. Create yöntemi başka bir XmlWriter nesneyi kabul edebilir. Temel alınan XmlWriter nesnenin statik Create yöntem tarafından oluşturulan bir XML yazıcısı olması gerekmez. Örneğin, ek özellikler eklemek için kullanıcı tanımlı bir XML yazıcısı belirtebilirsiniz.
Yalnızca statik Create yöntem tarafından oluşturulan nesnelerde XmlWriter kullanılabilen XML 1.0 önerisine daha iyi uyumluluk denetimi ve uyumluluk gibi özelliklerden tam olarak yararlanın.

Bir nesneyi kabul etmeyen bir Create XmlWriterSettings aşırı yükleme kullanırsanız, aşağıdaki varsayılan yazıcı ayarları kullanılır:

Ayar	Varsayılan
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	İki boşluk
NamespaceHandling	Default (kaldırma yok)
NewLineChars	`\r\n` (satır başı, yeni satır)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Not

.NET Framework, sınıfın XmlTextWriter somut bir uygulaması olan sınıfını XmlWriter içerse de, yöntemini kullanarak Create örnekler oluşturmanızı XmlWriter öneririz.

Create(StringBuilder, XmlWriterSettings)

ve XmlWriterSettings nesnelerini kullanarak StringBuilder yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: StringBuilder

StringBuilder Yazacakları yer. tarafından XmlWriter yazılan içerik öğesine StringBuildereklenir.

settings: XmlWriterSettings

Yeni XmlWriterSettings XmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarlara sahip bir XmlWriterSettings kullanılır.

XmlWriter yöntemiyle Transform(String, XmlWriter) kullanılıyorsa, doğru ayarlara sahip bir XmlWriterSettings nesne almak için özelliğini kullanmanız OutputSettings gerekir. Bu, oluşturulan XmlWriter nesnenin doğru çıkış ayarlarına sahip olmasını sağlar.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

builder değeri null olur.

Şunlara uygulanır

Create(String, XmlWriterSettings)

dosya adını ve XmlWriterSettings nesnesini kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

outputFileName: String

Yazmak istediğiniz dosya. belirtilen XmlWriter yolda bir dosya oluşturur ve XML 1.0 metin söz diziminde bu dosyaya yazar. outputFileName bir dosya sistemi yolu olmalıdır.

settings: XmlWriterSettings

Yeni XmlWriterSettings XmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarlara sahip bir XmlWriterSettings kullanılır.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

url değeri null olur.

Örnekler

Aşağıdaki örnek, tanımlı ayarlara sahip bir XmlWriter nesne oluşturur.

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

Şunlara uygulanır

Create(TextWriter, XmlWriterSettings)

ve XmlWriterSettings nesnelerini kullanarak TextWriter yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: TextWriter

TextWriter Yazmak istediğiniz. XML XmlWriter 1.0 metin söz dizimini yazar ve belirtilen TextWriteröğesine ekler.

settings: XmlWriterSettings

Yeni XmlWriterSettings XmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarlara sahip bir XmlWriterSettings kullanılır.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

text değeri null olur.

Örnekler

Aşağıdaki örnek bir XML dizesi yazar.

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

Şunlara uygulanır

Create(Stream, XmlWriterSettings)

Akışı ve XmlWriterSettings nesneyi kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: Stream

Yazmak istediğiniz akış. XML XmlWriter 1.0 metin söz dizimini yazar ve belirtilen akışa ekler.

settings: XmlWriterSettings

Yeni XmlWriterSettings XmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarlara sahip bir XmlWriterSettings kullanılır.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

stream değeri null olur.

Örnekler

Aşağıdaki örnek, bellek akışına bir XML parçası yazar.

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.

Açıklamalar

XmlWriter her zaman temel alınan veri akışına bir Bayt Sırası İşareti (BOM) yazar; ancak bazı akışlarda ürün reçetesi olmamalıdır. BOM'u atlayarak yeni XmlWriterSettings bir nesne oluşturun ve Encoding özelliğini oluşturucuda Boole değeri false olarak ayarlanmış yeni UTF8Encoding bir nesne olarak ayarlayın.

Şunlara uygulanır

Create(XmlWriter, XmlWriterSettings)

Belirtilen XmlWriter ve XmlWriterSettings nesnelerini kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: XmlWriter

XmlWriter Temel yazıcı olarak kullanmak istediğiniz nesne.

settings: XmlWriterSettings

Yeni XmlWriterSettings XmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarlara sahip bir XmlWriterSettings kullanılır.

Döndürülenler

XmlWriter

XmlWriter Belirtilen XmlWriter nesnenin çevresinde sarmalanmış bir nesne.

Özel durumlar

ArgumentNullException

writer değeri null olur.

Açıklamalar

Bu yöntem, temel alınan XmlWriter bir nesneye ek özellikler eklemenize olanak tanır. Temel alınan XmlWriter nesne, yöntemi tarafından XmlWriter.Create oluşturulan bir nesne veya uygulama kullanılarak XmlTextWriter oluşturulan bir nesne olabilir.

Şunlara uygulanır

Create(StringBuilder)

Belirtilen StringBuilderöğesini kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: StringBuilder

StringBuilder Yazacakları yer. tarafından XmlWriter yazılan içerik öğesine StringBuildereklenir.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

builder değeri null olur.

Açıklamalar

Bu aşırı yüklemeyi kullandığınızda, XML yazıcısını oluşturmak için varsayılan ayarlara sahip bir XmlWriterSettings nesne kullanılır.

Ayar	Varsayılan
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	İki boşluk
NamespaceHandling	Default (kaldırma yok)
NewLineChars	`\r\n` (satır başı, yeni satır)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Oluşturulan XML yazıcısında destekleyecek özellikleri belirtmek istiyorsanız, bir nesneyi bağımsız değişkenlerinden biri olarak alan XmlWriterSettings ve özel ayarlarınızla bir nesne geçiren bir XmlWriterSettings aşırı yükleme kullanın.

Şunlara uygulanır

Create(String)

Belirtilen dosya adını kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

outputFileName: String

Yazmak istediğiniz dosya. belirtilen XmlWriter yolda bir dosya oluşturur ve XML 1.0 metin söz diziminde bu dosyaya yazar. bir outputFileName dosya sistemi yolu olmalıdır.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

url değeri null olur.

Örnekler

Aşağıdaki örnek bir XmlWriter nesne oluşturur ve bir kitap düğümü yazar.

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

Açıklamalar

Bu aşırı yüklemeyi kullandığınızda, XML yazıcısını oluşturmak için varsayılan ayarlara sahip bir XmlWriterSettings nesne kullanılır.

Ayar	Varsayılan
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	İki boşluk
NamespaceHandling	Default (kaldırma yok)
NewLineChars	`\r\n` (satır başı, yeni satır)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Oluşturulan XML yazıcısında destek eklenecek özellikleri belirtmek istiyorsanız, bir nesneyi bağımsız değişkenlerinden biri olarak alan XmlWriterSettings ve özel ayarlarınızla bir nesne geçiren bir XmlWriterSettings aşırı yükleme kullanın.

Şunlara uygulanır

Create(TextWriter)

Belirtilen TextWriteröğesini kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: TextWriter

TextWriter Yazmak istediğiniz. XML XmlWriter 1.0 metin söz dizimini yazar ve belirtilen TextWriteröğesine ekler.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

text değeri null olur.

Örnekler

Aşağıdaki örnek, konsola çıkışını veren bir yazıcı oluşturur.

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

Açıklamalar

Bu aşırı yüklemeyi kullandığınızda, XML yazıcısını oluşturmak için varsayılan ayarlara sahip bir XmlWriterSettings nesne kullanılır.

Ayar	Varsayılan
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	İki boşluk
NamespaceHandling	Default (kaldırma yok)
NewLineChars	`\r\n` (satır başı, yeni satır)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Oluşturulan yazıcıda destek eklenecek özellikleri belirtmek istiyorsanız, bir XmlWriterSettings nesneyi bağımsız değişkenlerinden biri olarak alan ve özel ayarlarınızla bir nesne geçiren bir XmlWriterSettings aşırı yükleme kullanın.

Şunlara uygulanır

Create(Stream)

Belirtilen akışı kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: Stream

Yazmak istediğiniz akış. XML XmlWriter 1.0 metin söz dizimini yazar ve belirtilen akışa ekler.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

stream değeri null olur.

Örnekler

Aşağıdaki örnek, bellek akışına bir XML parçası yazar. (Yeni XML yazıcı örneğindeki Create(Stream, XmlWriterSettings) ayarları da yapılandıran aşırı yüklemeyi kullanır.)

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.

Açıklamalar

Bu aşırı yüklemeyi kullandığınızda, XML yazıcısını oluşturmak için aşağıdaki varsayılan ayarlara sahip bir XmlWriterSettings nesne kullanılır:

Ayar	Varsayılan
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	İki boşluk
NamespaceHandling	Default (kaldırma yok)
NewLineChars	`\r\n` (satır başı, yeni satır)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Ayrıca XmlWriter, temel alınan veri akışına her zaman bir Bayt Sırası İşareti (BOM) yazar; ancak bazı akışlarda ürün reçetesi olmamalıdır. BOM'u atlayarak yeni XmlWriterSettings bir nesne oluşturun ve Encoding özelliğini oluşturucuda Boole değeri false olarak ayarlanmış yeni UTF8Encoding bir nesne olarak ayarlayın.

Şunlara uygulanır

Create(XmlWriter)

Belirtilen XmlWriter nesneyi kullanarak yeni XmlWriter bir örnek oluşturur.

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

Parametreler

output: XmlWriter

XmlWriter Temel yazıcı olarak kullanmak istediğiniz nesne.

Döndürülenler

XmlWriter

XmlWriter Belirtilen XmlWriter nesnenin çevresinde sarmalanmış bir nesne.

Özel durumlar

ArgumentNullException

writer değeri null olur.

Açıklamalar

Bu yöntem, temel alınan XmlWriter bir nesneye özellik eklemenizi sağlar. Temel alınan XmlWriter nesne, yöntemi tarafından XmlWriter.Create oluşturulan bir nesne veya uygulama kullanılarak XmlTextWriter oluşturulan bir nesne olabilir.

Bu aşırı yüklemeyi kullandığınızda, XML yazıcısını oluşturmak için varsayılan ayarlara sahip bir XmlWriterSettings nesne kullanılır.

Ayar	Varsayılan
CheckCharacters	`true`
CloseOutput	`false`
ConformanceLevel	ConformanceLevel.Document
Encoding	Encoding.UTF8
Indent	`false`
IndentChars	İki boşluk
NamespaceHandling	Default (kaldırma yok)
NewLineChars	`\r\n` (satır başı, yeni satır)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	`false`
OmitXmlDeclaration	`false`
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	`true`

Şunlara uygulanır

Aracılığıyla paylaş

XmlWriter.Create Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

Create(StringBuilder, XmlWriterSettings)

Parametreler

Döndürülenler

Özel durumlar

Şunlara uygulanır

Create(String, XmlWriterSettings)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Şunlara uygulanır

Create(TextWriter, XmlWriterSettings)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Şunlara uygulanır

Create(Stream, XmlWriterSettings)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Create(XmlWriter, XmlWriterSettings)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Create(StringBuilder)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Create(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Create(TextWriter)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Create(Stream)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Create(XmlWriter)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar