XmlWriter.WriteAttributeString Metode

Definisi

Ruang nama:: System.Xml

Rakitan:: System.Xml.dll, System.Xml.ReaderWriter.dll

Rakitan:: netstandard.dll, System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.ReaderWriter.dll

Rakitan:: System.Xml.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Saat ditimpa di kelas turunan, menulis atribut dengan nilai yang ditentukan.

Overload

Nama	Deskripsi
WriteAttributeString(String, String, String, String)	Saat ditimpa dalam kelas turunan, tulis atribut dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.
WriteAttributeString(String, String, String)	Saat ditimpa dalam kelas turunan, menulis atribut dengan nama lokal, URI namespace, dan nilai yang ditentukan.
WriteAttributeString(String, String)	Saat ditimpa dalam kelas turunan, tulis atribut dengan nama dan nilai lokal yang ditentukan.

Keterangan

Untuk versi asinkron dari metode ini, lihat WriteElementStringAsync.

WriteAttributeString(String, String, String, String)

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Saat ditimpa dalam kelas turunan, tulis atribut dengan awalan, nama lokal, URI namespace, dan nilai yang ditentukan.

public:
 void WriteAttributeString(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);

public void WriteAttributeString(string prefix, string localName, string ns, string value);

public void WriteAttributeString(string? prefix, string localName, string? ns, string? value);

member this.WriteAttributeString : string * string * string * string -> unit

Public Sub WriteAttributeString (prefix As String, localName As String, ns As String, value As String)

Parameter

prefix: String

Awalan namespace atribut.

localName: String

Nama lokal atribut.

ns: String

URI namespace atribut.

value: String

Nilai dari atribut.

Pengecualian

InvalidOperationException

Status penulis tidak WriteState.Element atau penulis ditutup.

-atau-

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

ArgumentException

Nilai xml:space atribut atau xml:lang tidak valid.

XmlException

localName atau ns adalah null.

Contoh

Contoh berikut menggunakan WriteAttributeString metode untuk menulis deklarasi namespace.

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

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

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

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

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

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

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

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925")

     writer.WriteElementString("price", "19.95")

     ' Write the close tag for the root element.
     writer.WriteEndElement()
             
     ' Write the XML to file and close the writer.
     writer.Flush()
     writer.Close()  

  End Sub
End Class

Keterangan

Metode ini menulis atribut dengan awalan namespace yang ditentukan pengguna dan mengaitkannya dengan namespace yang diberikan. Jika awalannya adalah "xmlns" maka metode ini juga memperlakukan ini sebagai deklarasi namespace dan mengaitkan awalan yang dideklarasikan dengan URI namespace yang disediakan dalam nilai atribut yang diberikan. Dalam hal ns ini argumen dapat berupa null.

WriteAttributeString melakukan hal berikut:

Jika nilai atribut menyertakan tanda kutip ganda atau tunggal, nilai tersebut akan diganti dengan " dan ' masing-masing.
Jika menulis xml:space atribut, penulis memverifikasi nilai atribut valid. (Nilai yang valid adalah preserve atau default.)
Jika menulis xml:lang atribut, penulis tidak memverifikasi bahwa nilai atribut valid sesuai dengan rekomendasi W3C XML 1.0.

Untuk versi asinkron dari metode ini, lihat WriteAttributeStringAsync.

Berlaku untuk

WriteAttributeString(String, String, String)

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Saat ditimpa dalam kelas turunan, menulis atribut dengan nama lokal, URI namespace, dan nilai yang ditentukan.

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

public void WriteAttributeString(string localName, string ns, string value);

public void WriteAttributeString(string localName, string? ns, string? value);

member this.WriteAttributeString : string * string * string -> unit

Public Sub WriteAttributeString (localName As String, ns As String, value As String)

Parameter

localName: String

Nama lokal atribut.

ns: String

URI namespace untuk dikaitkan dengan atribut .

value: String

Nilai dari atribut.

Pengecualian

InvalidOperationException

Status penulis tidak WriteState.Element atau penulis ditutup.

-atau-

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

ArgumentException

Nilai xml:space atribut atau xml:lang tidak valid.

Contoh

Contoh berikut menggunakan WriteAttributeString metode untuk menulis deklarasi namespace.

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

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

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

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

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

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

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

Imports System.IO
Imports System.Xml

Public Class Sample 

  Public Shared Sub Main() 
 
     Dim writer As XmlWriter = Nothing

     writer = XmlWriter.Create("sampledata.xml")
        
     ' Write the root element.
     writer.WriteStartElement("book")

     ' Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", Nothing,"urn:book")
  
     ' Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925")

     writer.WriteElementString("price", "19.95")

     ' Write the close tag for the root element.
     writer.WriteEndElement()
             
     ' Write the XML to file and close the writer.
     writer.Flush()
     writer.Close()  

  End Sub
End Class

Keterangan

Metode ini menulis atribut dengan awalan namespace yang ditentukan pengguna dan mengaitkannya dengan namespace yang diberikan. Jika localName "xmlns" maka metode ini juga memperlakukan ini sebagai deklarasi namespace. Dalam hal ini, ns argumennya bisa .null

WriteAttributeString melakukan hal berikut:

Jika nilai atribut menyertakan tanda kutip ganda atau tunggal, nilai tersebut akan diganti dengan " dan ' masing-masing.
Jika menulis xml:space atribut, penulis memverifikasi nilai atribut valid. (Nilai yang valid adalah preserve atau default.)
Jika menulis xml:lang atribut, penulis tidak memverifikasi bahwa nilai atribut valid sesuai dengan rekomendasi W3C XML 1.0.

Untuk versi asinkron dari metode ini, lihat WriteAttributeStringAsync.

Berlaku untuk

WriteAttributeString(String, String)

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Sumber:: XmlWriter.cs

Saat ditimpa dalam kelas turunan, tulis atribut dengan nama dan nilai lokal yang ditentukan.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ value);

public void WriteAttributeString(string localName, string value);

public void WriteAttributeString(string localName, string? value);

member this.WriteAttributeString : string * string -> unit

Public Sub WriteAttributeString (localName As String, value As String)

Parameter

localName: String

Nama lokal atribut.

value: String

Nilai dari atribut.

Pengecualian

InvalidOperationException

Status penulis tidak WriteState.Element atau penulis ditutup.

-atau-

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

ArgumentException

Nilai xml:space atribut atau xml:lang tidak valid.

Contoh

Contoh berikut menulis buku.

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

WriteAttributeString melakukan hal berikut:

Jika nilai atribut menyertakan tanda kutip ganda atau tunggal, nilai tersebut akan diganti dengan " dan ' masing-masing.
Jika menulis xml:space atribut, penulis memverifikasi nilai atribut valid. (Nilai yang valid adalah preserve atau default.)
Jika menulis xml:lang atribut, penulis tidak memverifikasi bahwa nilai atribut valid sesuai dengan rekomendasi W3C XML 1.0.

Untuk versi asinkron dari metode ini, lihat WriteAttributeStringAsync.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?