XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString XmlWriter.WriteAttributeString Method

Definition

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Attribut mit dem angegebenen Wert. When overridden in a derived class, writes an attribute with the specified value.

Überlädt

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Attribut mit dem angegebenen lokalen Namen, Namespace-URI und Wert. When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert. When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen lokalen Namen und Wert. When overridden in a derived class, writes out the attribute with the specified local name and value.

Hinweise

Die asynchrone Version dieser Methode finden Sie unter WriteElementStringAsync.For the asynchronous version of this method, see WriteElementStringAsync.

WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse ein Attribut mit dem angegebenen lokalen Namen, Namespace-URI und Wert. When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

public:
 void WriteAttributeString(System::String ^ localName, System::String ^ ns, System::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 String String String

Der lokale Name des Attributs. The local name of the attribute.

ns
String String String String

Der Namespace-URI, der dem Attribut zugeordnet werden soll. The namespace URI to associate with the attribute.

value
String String String String

Der Wert des Attributs. The value of the attribute.

Ausnahmen

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Der xml:space-Attributwert oder der xml:lang-Attributwert ist ungültig. The xml:space or xml:lang attribute value is invalid.

Beispiele

Im folgenden Beispiel wird die WriteAttributeString Methode, um eine Namespacedeklaration zu schreiben.The following example uses the WriteAttributeString method to write a namespace declaration.

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

Hinweise

Diese Methode schreibt ein Attribut mit einem benutzerdefinierten Namespacepräfix und verknüpft es mit dem angegebenen Namespace.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Wenn localName ist "Xmlns", und klicken Sie dann diese Methode dies auch als eine Namespacedeklaration behandelt.If localName is "xmlns" then this method also treats this as a namespace declaration. In diesem Fall die ns -Argument kann es sich null.In this case, the ns argument can be null.

WriteAttributeString führt Folgendes aus:WriteAttributeString does the following:

  • Wenn der Attributwert doppelte oder einfache Anführungszeichen enthält, werden sie durch ersetzt &quot; und &apos; bzw.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Wenn beim Schreiben einer xml:space -Attribut der Writer überprüft den Wert des Attributs ist gültig.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Gültige Werte sind preserve oder default.)(Valid values are preserve or default.)

  • Wenn beim Schreiben einer xml:lang -Attribut, der Writer überprüft nicht, den Wert des Attributs gemäß der W3C XML 1.0-Empfehlung gültig ist.If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

Die asynchrone Version dieser Methode finden Sie unter WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert. When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

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);
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 String String String

Das Namespacepräfix des Attributs. The namespace prefix of the attribute.

localName
String String String String

Der lokale Name des Attributs. The local name of the attribute.

ns
String String String String

Der Namespace-URI dieses Attributs. The namespace URI of the attribute.

value
String String String String

Der Wert des Attributs. The value of the attribute.

Ausnahmen

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Der xml:space-Attributwert oder der xml:lang-Attributwert ist ungültig. The xml:space or xml:lang attribute value is invalid.

localName oder ns ist null. The localName or ns is null.

Beispiele

Im folgenden Beispiel wird die WriteAttributeString Methode, um eine Namespacedeklaration zu schreiben.The following example uses the WriteAttributeString method to write a namespace declaration.

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

Hinweise

Diese Methode schreibt ein Attribut mit einem benutzerdefinierten Namespacepräfix und verknüpft es mit dem angegebenen Namespace.This method writes out the attribute with a user defined namespace prefix and associates it with the given namespace. Wenn das Präfix "Xmlns" ist dann diese Methode auch behandelt diesen als eine Namespacedeklaration und ordnet das deklarierte Präfix der Namespace-URI in der angegebenen Attribut-Wert angegeben.If the prefix is "xmlns" then this method also treats this as a namespace declaration and associates the declared prefix with the namespace URI provided in the given attribute value. In diesem Fall die ns -Argument kann es sich null.In this case the ns argument can be null.

WriteAttributeString führt Folgendes aus:WriteAttributeString does the following:

  • Wenn der Attributwert doppelte oder einfache Anführungszeichen enthält, werden sie durch ersetzt &quot; und &apos; bzw.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Wenn beim Schreiben einer xml:space -Attribut der Writer überprüft den Wert des Attributs ist gültig.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Gültige Werte sind preserve oder default.)(Valid values are preserve or default.)

  • Wenn beim Schreiben einer xml:lang -Attribut, der Writer überprüft nicht, den Wert des Attributs gemäß der W3C XML 1.0-Empfehlung gültig ist.If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

Die asynchrone Version dieser Methode finden Sie unter WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen lokalen Namen und Wert. When overridden in a derived class, writes out the attribute with the specified local name and value.

public:
 void WriteAttributeString(System::String ^ localName, System::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 String String String

Der lokale Name des Attributs. The local name of the attribute.

value
String String String String

Der Wert des Attributs. The value of the attribute.

Ausnahmen

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst. In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Der xml:space-Attributwert oder der xml:lang-Attributwert ist ungültig. The xml:space or xml:lang attribute value is invalid.

Beispiele

Im folgende Beispiel wird ein Buch geschrieben.The following example writes out a book.

#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
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 'Main 
End Class 'Sample

Hinweise

WriteAttributeString führt Folgendes aus:WriteAttributeString does the following:

  • Wenn der Attributwert doppelte oder einfache Anführungszeichen enthält, werden sie durch ersetzt &quot; und &apos; bzw.If the attribute value includes double or single quotes, they are replaced with &quot; and &apos; respectively.

  • Wenn beim Schreiben einer xml:space -Attribut der Writer überprüft den Wert des Attributs ist gültig.If writing an xml:space attribute, the writer verifies the attribute value is valid. (Gültige Werte sind preserve oder default.)(Valid values are preserve or default.)

  • Wenn beim Schreiben einer xml:lang -Attribut, der Writer überprüft nicht, den Wert des Attributs gemäß der W3C XML 1.0-Empfehlung gültig ist.If writing an xml:lang attribute, the writer does not verify that the attribute value is valid according to the W3C XML 1.0 recommendation.

Die asynchrone Version dieser Methode finden Sie unter WriteAttributeStringAsync.For the asynchronous version of this method, see WriteAttributeStringAsync.

Gilt für: