XmlWriter.WriteStartElement Yöntem

Tanım

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

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.

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

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.

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.

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

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.

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