XmlWriter.WriteStartElement 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.

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar.

Aşırı Yüklemeler

WriteStartElement(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen yerel ada sahip bir başlangıç etiketi yazar.
WriteStartElement(String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar ve belirtilen ad alanıyla ilişkilendirir.
WriteStartElement(String, String, String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar ve belirtilen ad alanı ve ön ek ile ilişkilendirir.

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartElementAsync. .

WriteStartElement(String)

Kaynak:: XmlWriter.cs

Kaynak:: XmlWriter.cs

Kaynak:: XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen yerel ada sahip bir başlangıç etiketi yazar.

public:
 void WriteStartElement(System::String ^ localName);

public void WriteStartElement (string localName);

member this.WriteStartElement : string -> unit

Public Sub WriteStartElement (localName As String)

Parametreler

localName: String

Öğesinin yerel adı.

Özel durumlar

InvalidOperationException

Yazar kapatıldı.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

EncoderFallbackException

Arabellekte geçerli bir XML karakteri olan ancak çıkış kodlaması için geçerli olmayan bir karakter vardır. Örneğin, çıkış kodlaması ASCII ise, öğe ve öznitelik adları için yalnızca 0 ile 127 aralığındaki karakterleri kullanmanız gerekir. Geçersiz karakter bu yöntemin bağımsız değişkeninde veya arabelleğe yazan önceki yöntemlerin bağımsız değişkeninde olabilir. Bu tür karakterler mümkün olduğunda karakter varlığı başvuruları tarafından kaçış karakteri kullanılır (örneğin, metin düğümlerinde veya öznitelik değerlerinde). Ancak, öğe ve öznitelik adlarında, açıklamalarda, işleme yönergelerinde veya CDATA bölümlerinde karakter varlığı başvurusuna izin verilmez.

Örnekler

Aşağıdaki örnek bir XML düğümü yazar.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create a writer to write XML to the console.
   XmlWriterSettings^ settings = gcnew XmlWriterSettings;
   settings->Indent = true;
   settings->OmitXmlDeclaration = true;
   XmlWriter^ writer = XmlWriter::Create( Console::Out, settings );
   
   // Write the book element.
   writer->WriteStartElement( L"book" );
   
   // Write the title element.
   writer->WriteStartElement( L"title" );
   writer->WriteString( L"Pride And Prejudice" );
   writer->WriteEndElement();
   
   // Write the close tag for the root element.
   writer->WriteEndElement();
   
   // Write the XML and close the writer.
   writer->Close();
   return 1;
}

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write the book element.
     writer.WriteStartElement("book");

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML and close the writer.
     writer.Close();
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
  Public Shared Sub Main()

     ' Create a writer to write XML to the console.
     Dim settings As XmlWriterSettings = new XmlWriterSettings()
     settings.Indent = true
     settings.OmitXmlDeclaration = true
     Dim writer As XmlWriter = XmlWriter.Create(Console.Out, settings)

     ' Write the book element.
     writer.WriteStartElement("book")
        
     ' Write the title element.
     writer.WriteStartElement("title")
     writer.WriteString("Pride And Prejudice")
     writer.WriteEndElement()
        
     ' Write the close tag for the root element.
     writer.WriteEndElement()
        
     ' Write the XML and close the writer.
     writer.Close()

  End Sub
End Class

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartElementAsync. .

Şunlara uygulanır

WriteStartElement(String, String)

Kaynak:: XmlWriter.cs

Kaynak:: XmlWriter.cs

Kaynak:: XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar ve belirtilen ad alanıyla ilişkilendirir.

public:
 void WriteStartElement(System::String ^ localName, System::String ^ ns);

public void WriteStartElement (string localName, string ns);

public void WriteStartElement (string localName, string? ns);

member this.WriteStartElement : string * string -> unit

Public Sub WriteStartElement (localName As String, ns As String)

Parametreler

localName: String

Öğesinin yerel adı.

ns: String

öğesiyle ilişkilendirilecek ad alanı URI'si. Bu ad alanı zaten kapsamdaysa ve ilişkili bir ön eke sahipse, yazıcı bu ön eki de otomatik olarak yazar.

Özel durumlar

InvalidOperationException

Yazar kapatıldı.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

EncoderFallbackException

Açıklamalar

Bu yöntemi çağırdıktan sonra öznitelik yazabilir veya , WriteStringWriteStartElement veya alt öğeler için kullanarak WriteCommentiçerik oluşturabilirsiniz. öğesini veya WriteFullEndElementile WriteEndElement kapatabilirsiniz. Örneğin, aşağıdaki C# kodu:

writer.WriteStartElement("item",null);
writer.WriteString("some text");
writer.WriteEndElement();

Aşağıdaki çıkışı oluşturur:

<item>some text</item>

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartElementAsync. .

Şunlara uygulanır

WriteStartElement(String, String, String)

Kaynak:: XmlWriter.cs

Kaynak:: XmlWriter.cs

Kaynak:: XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen başlangıç etiketini yazar ve belirtilen ad alanı ve ön ek ile ilişkilendirir.

public:
 abstract void WriteStartElement(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public abstract void WriteStartElement (string prefix, string localName, string ns);

public abstract void WriteStartElement (string? prefix, string localName, string? ns);

abstract member WriteStartElement : string * string * string -> unit

Public MustOverride Sub WriteStartElement (prefix As String, localName As String, ns As String)

Parametreler

prefix: String

öğesinin ad alanı ön eki.

localName: String

Öğesinin yerel adı.

ns: String

öğesiyle ilişkilendirilecek ad alanı URI'si.

Özel durumlar

InvalidOperationException

Yazar kapatıldı.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

EncoderFallbackException

Örnekler

Aşağıdaki örnek bir XML parçası yazar.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
public ref class Sample
{
private:
   static String^ m_Document = L"sampledata.xml";

public:
   static void Main()
   {
      XmlWriter^ writer = nullptr;
      try
      {
         XmlWriterSettings^ settings = gcnew XmlWriterSettings;
         settings->Indent = true;
         writer = XmlWriter::Create( m_Document,settings );
         writer->WriteComment( L"sample XML fragment" );
         
         // Write an element (this one is the root).
         writer->WriteStartElement( L"book" );
         
         // Write the namespace declaration.
         writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:samples" );
         
         // Write the genre attribute.
         writer->WriteAttributeString( L"genre", L"novel" );
         
         // Write the title.
         writer->WriteStartElement( L"title" );
         writer->WriteString( L"The Handmaid's Tale" );
         writer->WriteEndElement();
         
         // Write the price.
         writer->WriteElementString( L"price", L"19.95" );
         
         // Lookup the prefix and write the ISBN element.
         String^ prefix = writer->LookupPrefix( L"urn:samples" );
         writer->WriteStartElement( prefix, L"ISBN", L"urn:samples" );
         writer->WriteString( L"1-861003-78" );
         writer->WriteEndElement();
         
         // Write the style element (shows a different way to handle prefixes).
         writer->WriteElementString( L"style", L"urn:samples", L"hardcover" );
         
         // Write the close tag for the root element.
         writer->WriteEndElement();
         
         // Write the XML to file and close the writer.
         writer->Flush();
         writer->Close();
      }
      finally
      {
         if ( writer != nullptr )
                  writer->Close();
      }

   }

};

void main()
{
   Sample::Main();
}

using System;
using System.IO;
using System.Xml;

 public class Sample
 {
   private const string m_Document = "sampledata.xml";

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

        // Write the genre attribute.
        writer.WriteAttributeString("genre", "novel");

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

        // Write the price.
        writer.WriteElementString("price", "19.95");

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

        // Write the close tag for the root element.
        writer.WriteEndElement();

        // Write the XML to file and close the writer.
        writer.Flush();
        writer.Close();
      }

      finally {
        if (writer != null)
           writer.Close();
     }
   }
 }

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared m_Document As String = "sampledata.xml"
    
    Public Shared Sub Main()
        Dim writer As XmlWriter = Nothing
        
      Try

        Dim settings As XmlWriterSettings = new XmlWriterSettings()
        settings.Indent = true
        writer = XmlWriter.Create (m_Document, settings)
            
        writer.WriteComment("sample XML fragment")
            
        ' Write an element (this one is the root).
        writer.WriteStartElement("book")
            
        ' Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", Nothing, "urn:samples")
            
        ' Write the genre attribute.
        writer.WriteAttributeString("genre", "novel")
            
        ' Write the title.
        writer.WriteStartElement("title")
        writer.WriteString("The Handmaid's Tale")
        writer.WriteEndElement()
            
        ' Write the price.
        writer.WriteElementString("price", "19.95")
            
        ' Lookup the prefix and write the ISBN element.
        Dim prefix As String = writer.LookupPrefix("urn:samples")
        writer.WriteStartElement(prefix, "ISBN", "urn:samples")
        writer.WriteString("1-861003-78")
        writer.WriteEndElement()
            
        ' Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover")
            
        ' Write the close tag for the root element.
        writer.WriteEndElement()
            
        ' Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        Finally
            If Not (writer Is Nothing) Then
                writer.Close()
            End If
        End Try

    End Sub
End Class

Açıklamalar

Bu yöntemin zaman uyumsuz sürümü için bkz WriteStartElementAsync. .

Şunlara uygulanır

Aracılığıyla paylaş

XmlWriter.WriteStartElement Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

WriteStartElement(String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

WriteStartElement(String, String)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteStartElement(String, String, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar