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

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen değere sahip bir öznitelik yazar.

Aşırı Yüklemeler

WriteAttributeString(String, String, String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen ön ek, yerel ad, ad alanı URI'si ve değeriyle özniteliğini yazar.
WriteAttributeString(String, String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen yerel ada, ad alanı URI'sine ve değerine sahip bir öznitelik yazar.
WriteAttributeString(String, String)

Türetilmiş bir sınıfta geçersiz kılındığında, özniteliği belirtilen yerel ad ve değerle yazar.

Açıklamalar

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

WriteAttributeString(String, 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 ön ek, yerel ad, ad alanı URI'si ve değeriyle özniteliğini yazar.

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)

Parametreler

prefix
String

Özniteliğin ad alanı ön eki.

localName
String

Özniteliğin yerel adı.

ns
String

Özniteliğin ad alanı URI'si.

value
String

özniteliğinin değeri.

Özel durumlar

InvalidOperationException

Yazıcının durumu değil WriteState.Element veya yazar kapalı.

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

ArgumentException

xml:space veya xml:lang öznitelik değeri geçersiz.

XmlException

localName veya ns şeklindedirnull.

Örnekler

Aşağıdaki örnek, ad alanı bildirimi yazmak için yöntemini kullanır WriteAttributeString .

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"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();
}

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

Açıklamalar

Bu yöntem, özniteliği kullanıcı tanımlı bir ad alanı ön eki ile yazar ve verilen ad alanıyla ilişkilendirir. Ön ek "xmlns" ise, bu yöntem bunu bir ad alanı bildirimi olarak da değerlendirir ve bildirilen ön eki verilen öznitelik değerinde sağlanan ad alanı URI'si ile ilişkilendirir. Bu durumda ns bağımsız değişken olabilir null.

WriteAttributeString aşağıdakileri yapar:

  • Öznitelik değeri çift veya tek tırnak içeriyorsa, bunlar sırasıyla ve &apos; ile &quot; değiştirilir.

  • Bir xml:space öznitelik yazıyorsanız, yazıcı öznitelik değerinin geçerli olduğunu doğrular. (Geçerli değerler veya default'dırpreserve))

  • Bir xml:lang öznitelik yazıyorsanız, yazıcı öznitelik değerinin W3C XML 1.0 önerisine göre geçerli olduğunu doğrulamaz.

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

Şunlara uygulanır

WriteAttributeString(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 yerel ada, ad alanı URI'sine ve değerine sahip bir öznitelik yazar.

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)

Parametreler

localName
String

Özniteliğin yerel adı.

ns
String

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

value
String

özniteliğinin değeri.

Özel durumlar

InvalidOperationException

Yazıcının durumu değil WriteState.Element veya yazar kapalı.

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

ArgumentException

xml:space veya xml:lang öznitelik değeri geçersiz.

Örnekler

Aşağıdaki örnek, ad alanı bildirimi yazmak için yöntemini kullanır WriteAttributeString .

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
void main()
{
   XmlWriter^ writer = nullptr;
   writer = XmlWriter::Create( L"sampledata.xml" );
   
   // Write the root element.
   writer->WriteStartElement( L"book" );
   
   // Write the xmlns:bk="urn:book" namespace declaration.
   writer->WriteAttributeString( L"xmlns", L"bk", nullptr, L"urn:book" );
   
   // Write the bk:ISBN="1-800-925" attribute.
   writer->WriteAttributeString( L"ISBN", L"urn:book", L"1-800-925" );
   writer->WriteElementString( L"price", L"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();
}

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

Açıklamalar

Bu yöntem, özniteliği kullanıcı tanımlı bir ad alanı ön eki ile yazar ve verilen ad alanıyla ilişkilendirir. " localName xmlns" ise, bu yöntem bunu bir ad alanı bildirimi olarak da ele alır. Bu durumda bağımsız ns değişken olabilir null.

WriteAttributeString aşağıdakileri yapar:

  • Öznitelik değeri çift veya tek tırnak içeriyorsa, bunlar sırasıyla ve &apos; ile &quot; değiştirilir.

  • Bir xml:space öznitelik yazıyorsanız, yazıcı öznitelik değerinin geçerli olduğunu doğrular. (Geçerli değerler veya default'dırpreserve))

  • Bir xml:lang öznitelik yazıyorsanız, yazıcı öznitelik değerinin W3C XML 1.0 önerisine göre geçerli olduğunu doğrulamaz.

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

Şunlara uygulanır

WriteAttributeString(String, String)

Kaynak:
XmlWriter.cs
Kaynak:
XmlWriter.cs
Kaynak:
XmlWriter.cs

Türetilmiş bir sınıfta geçersiz kılındığında, özniteliği belirtilen yerel ad ve değerle yazar.

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)

Parametreler

localName
String

Özniteliğin yerel adı.

value
String

özniteliğinin değeri.

Özel durumlar

InvalidOperationException

Yazıcının durumu değil WriteState.Element veya yazar kapalı.

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

ArgumentException

xml:space veya xml:lang öznitelik değeri geçersiz.

Örnekler

Aşağıdaki örnek bir kitap 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

WriteAttributeString aşağıdakileri yapar:

  • Öznitelik değeri çift veya tek tırnak içeriyorsa, bunlar sırasıyla ve &apos; ile &quot; değiştirilir.

  • Bir xml:space öznitelik yazıyorsanız, yazıcı öznitelik değerinin geçerli olduğunu doğrular. (Geçerli değerler veya default'dırpreserve))

  • Bir xml:lang öznitelik yazıyorsanız, yazıcı öznitelik değerinin W3C XML 1.0 önerisine göre geçerli olduğunu doğrulamaz.

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

Şunlara uygulanır