XmlWriter.Create Yöntem

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

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.

C#

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings settings);

C#

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output, System.Xml.XmlWriterSettings? settings);

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.

Create(String, XmlWriterSettings)

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

C#

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings? settings);

C#

public static System.Xml.XmlWriter Create (string outputFileName, System.Xml.XmlWriterSettings settings);

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

ArgumentNullException

url değeri null olur.

Örnekler

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

C#

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();
     }
  }
}

Create(TextWriter, XmlWriterSettings)

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

C#

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings settings);

C#

public static System.Xml.XmlWriter Create (System.IO.TextWriter output, System.Xml.XmlWriterSettings? settings);

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

ArgumentNullException

text değeri null olur.

Örnekler

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

C#

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();
}

Create(Stream, XmlWriterSettings)

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

C#

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings settings);

C#

public static System.Xml.XmlWriter Create (System.IO.Stream output, System.Xml.XmlWriterSettings? settings);

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

ArgumentNullException

stream değeri null olur.

Örnekler

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

C#

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.

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.

Create(XmlWriter, XmlWriterSettings)

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

C#

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings settings);

C#

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output, System.Xml.XmlWriterSettings? settings);

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

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.

Create(StringBuilder)

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

C#

public static System.Xml.XmlWriter Create (System.Text.StringBuilder output);

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.

Create(String)

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

C#

public static System.Xml.XmlWriter Create (string outputFileName);

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.

C#

using (XmlWriter writer = XmlWriter.Create("output.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

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.

Create(TextWriter)

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

C#

public static System.Xml.XmlWriter Create (System.IO.TextWriter output);

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.

C#

using (XmlWriter writer = XmlWriter.Create(Console.Out))
{
    writer.WriteStartElement("book");
    writer.WriteElementString("price", "19.95");
    writer.WriteEndElement();
    writer.Flush();
}

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.

Create(Stream)

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

C#

public static System.Xml.XmlWriter Create (System.IO.Stream output);

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.)

C#

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.

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.

Create(XmlWriter)

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

C#

public static System.Xml.XmlWriter Create (System.Xml.XmlWriter output);

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

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.