XmlWriter.Create Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Yeni bir XmlWriter örneği oluşturur.

Aşırı Yüklemeler

Name	Description
Create(StringBuilder, XmlWriterSettings)	ve XmlWriter nesnelerini kullanarak StringBuilder yeni XmlWriterSettings bir örnek oluşturur.
Create(String, XmlWriterSettings)	Dosya adını ve XmlWriter nesnesini kullanarak yeni XmlWriterSettings bir örnek oluşturur.
Create(TextWriter, XmlWriterSettings)	ve XmlWriter nesnelerini kullanarak TextWriter yeni XmlWriterSettings bir örnek oluşturur.
Create(Stream, XmlWriterSettings)	Akışı ve XmlWriter nesnesini kullanarak yeni XmlWriterSettings bir örnek oluşturur.
Create(XmlWriter, XmlWriterSettings)	Belirtilen XmlWriter ve XmlWriter nesnelerini kullanarak yeni XmlWriterSettings bir örnek oluşturur.
Create(StringBuilder)	Belirtilen XmlWriterkullanarak yeni StringBuilder bir örnek oluşturur.
Create(String)	Belirtilen dosya adını kullanarak yeni XmlWriter bir örnek oluşturur.
Create(TextWriter)	Belirtilen XmlWriterkullanarak yeni TextWriter 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 settingsXmlWriterSettings parametre içerir. Bu nesneyi kullanarak:

• Oluşturulan XmlWriter nesnede hangi özelliklerin destekleneceğini belirtin.

• XmlWriterSettings Birden çok yazıcı nesnesi oluşturmak için nesnesini yeniden kullanma. XmlWriterSettings Nesne 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 yazarları 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.

• Var olan 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 yöntem tarafından oluşturulan nesnelerde XmlWriter kullanılabilen Create daha iyi uyumluluk denetimi ve uyumluluk gibi özelliklerden tam olarak yararlanın.

Bir nesneyi kabul etmeyen bir CreateXmlWriterSettings 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ırılma yok)
NewLineChars	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Note

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

Create(StringBuilder, XmlWriterSettings)

Kaynak:

XmlWriter.cs

ve XmlWriter nesnelerini kullanarak StringBuilder yeni XmlWriterSettings 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);

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 Yazıldığı yer. tarafından XmlWriter yazılan içerik sonuna StringBuildereklenir.

settings

XmlWriterSettings

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

XmlWriter yöntemiyle Transform(String, XmlWriter) kullanılıyorsa, doğru ayarlara sahip bir OutputSettings nesne almak için özelliğini kullanmanız XmlWriterSettings 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

output, null'e eşittir.

Create(String, XmlWriterSettings)

Kaynak:

XmlWriter.cs

Dosya adını ve XmlWriter nesnesini kullanarak yeni XmlWriterSettings 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);

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 XmlWriterSettingsXmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarları olan bir XmlWriterSettings kullanılır.

XmlWriter yöntemiyle Transform(String, XmlWriter) kullanılıyorsa, doğru ayarlara sahip bir OutputSettings nesne almak için özelliğini kullanmanız XmlWriterSettings 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

outputFileName, null'e eşittir.

Örnekler

Aşağıdaki örnek, tanımlı ayarlarla 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

Create(TextWriter, XmlWriterSettings)

Kaynak:

XmlWriter.cs

ve XmlWriter nesnelerini kullanarak TextWriter yeni XmlWriterSettings 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);

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 XmlWriterSettingsXmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarları olan bir XmlWriterSettings kullanılır.

XmlWriter yöntemiyle Transform(String, XmlWriter) kullanılıyorsa, doğru ayarlara sahip bir OutputSettings nesne almak için özelliğini kullanmanız XmlWriterSettings 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

output, null'e eşittir.

Ö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

Create(Stream, XmlWriterSettings)

Kaynak:

XmlWriter.cs

Akışı ve XmlWriter nesnesini kullanarak yeni XmlWriterSettings 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);

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 XmlWriterSettingsXmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarları olan bir XmlWriterSettings kullanılır.

XmlWriter yöntemiyle Transform(String, XmlWriter) kullanılıyorsa, doğru ayarlara sahip bir OutputSettings nesne almak için özelliğini kullanmanız XmlWriterSettings 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

output, null'e eşittir.

Ö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 bayt sipariş işareti (BOM) yazar; ancak bazı akışlarda ürün reçetesi olmamalıdır. BOM'u atlamak için 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.

Create(XmlWriter, XmlWriterSettings)

Kaynak:

XmlWriter.cs

Belirtilen XmlWriter ve XmlWriter nesnelerini kullanarak yeni XmlWriterSettings 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);

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 XmlWriterSettingsXmlWriter örneği yapılandırmak için kullanılan nesne. Bu ise null, varsayılan ayarları olan bir XmlWriterSettings kullanılır.

XmlWriter yöntemiyle Transform(String, XmlWriter) kullanılıyorsa, doğru ayarlara sahip bir OutputSettings nesne almak için özelliğini kullanmanız XmlWriterSettings 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 etrafında sarmalanmış bir nesne.

Özel durumlar

ArgumentNullException

output, null'e eşittir.

Açıklamalar

Bu yöntem, temel alınan XmlWriter 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.

Create(StringBuilder)

Kaynak:

XmlWriter.cs

Belirtilen XmlWriterkullanarak yeni StringBuilder 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 Yazıldığı yer. tarafından XmlWriter yazılan içerik sonuna StringBuildereklenir.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

output, null'e eşittir.

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ırılma yok)
NewLineChars	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
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.

Create(String)

Kaynak:

XmlWriter.cs

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. outputFileName bir dosya sistemi yolu olmalıdır.

Döndürülenler

XmlWriter

Bir XmlWriter nesnesi.

Özel durumlar

ArgumentNullException

outputFileName, null'e eşittir.

Ö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ırılma yok)
NewLineChars	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
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.

Create(TextWriter)

Kaynak:

XmlWriter.cs

Belirtilen XmlWriterkullanarak yeni TextWriter 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

output, null'e eşittir.

Ö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ırılma yok)
NewLineChars	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Oluşturulan yazıcıda destekleneceğini ö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.

Create(Stream)

Kaynak:

XmlWriter.cs

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

output, null'e eşittir.

Ö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ırılma yok)
NewLineChars	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
NewLineHandling	NewLineHandling.Replace
NewLineOnAttributes	false
OmitXmlDeclaration	false
OutputMethod	XmlOutputMethod.Xml
WriteEndDocumentOnClose	true

Oluşturulan yazıcıda destekleneceğini ö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.

Ayrıca, 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 atlamak için 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.

Create(XmlWriter)

Kaynak:

XmlWriter.cs

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 etrafında sarmalanmış bir nesne.

Özel durumlar

ArgumentNullException

output, null'e eşittir.

Açıklamalar

Bu yöntem, temel alınan XmlWriter bir nesneye özellik 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.

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ırılma yok)
NewLineChars	\r\n Unix dışı platformlar için (satır başı, satır besleme) veya \n Unix platformları için (satır besleme)
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.