Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

XmlWriter.WriteAttributeString-Methode: (String, String)

 

Veröffentlicht: Oktober 2016

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen lokalen Namen und Wert.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public void WriteAttributeString(
	string localName,
	string value
)

Parameter

localName
Type: System.String

Der lokale Name des Attributs.

value
Type: System.String

Der Wert des Attributs.

Exception Condition
InvalidOperationException

Der Zustand des Writers ist nicht WriteState.Element oder der Writer ist geschlossen.

ArgumentException

Die xml:space oder xml:lang Attributwert ist ungültig.

InvalidOperationException

Eine XmlWriter Methode wurde aufgerufen, bevor der vorherige asynchroner Vorgang abgeschlossen. In diesem Fall InvalidOperationException wird ausgelöst, mit der Meldung "ein asynchroner Vorgang ist bereits in Bearbeitung."

WriteAttributeString führt Folgendes aus:

  • Wenn der Attributwert doppelte oder einfache Anführungszeichen enthält, werden sie durch ersetzt " und ' bzw..

  • Wenn ein xml:space -Attribut der Writer überprüft der Attributwert ist ungültig. (Gültige Werte sind preserve oder default.)

  • Wenn ein xml:lang -Attribut der Writer überprüft nicht, den Wert des Attributs gemäß W3C XML 1.0-Empfehlung gültig ist.

Die asynchrone Version dieser Methode finden Sie unter WriteAttributeStringAsync.

Im folgende Beispiel wird ein Buch geschrieben.

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();
     } 
   }

 }

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: