Aracılığıyla paylaş


XmlWriter.Create Yöntem

Tanım

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

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.

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

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.

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

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.

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

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.

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

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

Özel durumlar

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

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

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

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

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

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.

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

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

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