XmlWriter.WriteStartElement Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Saat ditimpa di kelas turunan, tulis tag mulai yang ditentukan.

Overload

Nama	Deskripsi
WriteStartElement(String)	Saat ditimpa di kelas turunan, tulis tag mulai dengan nama lokal yang ditentukan.
WriteStartElement(String, String)	Saat ditimpa di kelas turunan, menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace yang diberikan.
WriteStartElement(String, String, String)	Ketika ditimpa dalam kelas turunan, menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace layanan dan awalan yang diberikan.

Keterangan

Untuk versi asinkron dari metode ini, lihat WriteStartElementAsync.

WriteStartElement(String)

Sumber:

XmlWriter.cs

Saat ditimpa di kelas turunan, tulis tag mulai dengan nama lokal yang ditentukan.

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

public void WriteStartElement(string localName);

member this.WriteStartElement : string -> unit

Public Sub WriteStartElement (localName As String)

Parameter

localName

String

Nama lokal elemen .

Pengecualian

InvalidOperationException

Penulis ditutup.

-atau-

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

EncoderFallbackException

Ada karakter dalam buffer yang merupakan karakter XML yang valid tetapi tidak valid untuk pengodean output. Misalnya, jika pengodean output adalah ASCII, Anda hanya boleh menggunakan karakter dari rentang 0 hingga 127 untuk nama elemen dan atribut. Karakter yang tidak valid mungkin berada dalam argumen metode ini atau dalam argumen metode sebelumnya yang menulis ke buffer. Karakter tersebut diloloskan oleh referensi entitas karakter jika memungkinkan (misalnya, dalam node teks atau nilai atribut). Namun, referensi entitas karakter tidak diizinkan dalam elemen dan nama atribut, komentar, instruksi pemrosesan, atau bagian CDATA.

Contoh

Contoh berikut menulis simpul XML.

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

Keterangan

Untuk versi asinkron dari metode ini, lihat WriteStartElementAsync.

WriteStartElement(String, String)

Sumber:

XmlWriter.cs

Saat ditimpa di kelas turunan, menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace yang diberikan.

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

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

member this.WriteStartElement : string * string -> unit

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

Parameter

localName

String

Nama lokal elemen .

ns

String

URI namespace untuk dikaitkan dengan elemen . Jika namespace layanan ini sudah berada dalam cakupan dan memiliki awalan terkait, penulis secara otomatis menulis awalan tersebut juga.

Pengecualian

InvalidOperationException

Penulis ditutup.

-atau-

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

EncoderFallbackException

Ada karakter dalam buffer yang merupakan karakter XML yang valid tetapi tidak valid untuk pengodean output. Misalnya, jika pengodean output adalah ASCII, Anda hanya boleh menggunakan karakter dari rentang 0 hingga 127 untuk nama elemen dan atribut. Karakter yang tidak valid mungkin berada dalam argumen metode ini atau dalam argumen metode sebelumnya yang menulis ke buffer. Karakter tersebut diloloskan oleh referensi entitas karakter jika memungkinkan (misalnya, dalam node teks atau nilai atribut). Namun, referensi entitas karakter tidak diizinkan dalam elemen dan nama atribut, komentar, instruksi pemrosesan, atau bagian CDATA.

Keterangan

Setelah memanggil metode ini, Anda dapat menulis atribut, atau membuat konten menggunakan WriteComment, , WriteStringatau WriteStartElement untuk elemen anak. Anda dapat menutup elemen dengan atau WriteEndElementWriteFullEndElement. Misalnya, kode C# berikut:

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

Menghasilkan output berikut:

<item>some text</item>

Untuk versi asinkron dari metode ini, lihat WriteStartElementAsync.

WriteStartElement(String, String, String)

Sumber:

XmlWriter.cs

Ketika ditimpa dalam kelas turunan, menulis tag mulai yang ditentukan dan mengaitkannya dengan namespace layanan dan awalan yang diberikan.

public:
 abstract void WriteStartElement(System::String ^ prefix, System::String ^ localName, System::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)

Parameter

prefix

String

Awalan namespace elemen.

localName

String

Nama lokal elemen .

ns

String

URI namespace untuk dikaitkan dengan elemen .

Pengecualian

InvalidOperationException

Penulis ditutup.

-atau-

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

EncoderFallbackException

Ada karakter dalam buffer yang merupakan karakter XML yang valid tetapi tidak valid untuk pengodean output. Misalnya, jika pengodean output adalah ASCII, Anda hanya boleh menggunakan karakter dari rentang 0 hingga 127 untuk nama elemen dan atribut. Karakter yang tidak valid mungkin berada dalam argumen metode ini atau dalam argumen metode sebelumnya yang menulis ke buffer. Karakter tersebut diloloskan oleh referensi entitas karakter jika memungkinkan (misalnya, dalam node teks atau nilai atribut). Namun, referensi entitas karakter tidak diizinkan dalam elemen dan nama atribut, komentar, instruksi pemrosesan, atau bagian CDATA.

Contoh

Contoh berikut menulis fragmen XML.

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

Keterangan

Untuk versi asinkron dari metode ini, lihat WriteStartElementAsync.