Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

XmlWriter.WriteAttributeString-Methode (String, String, String, String)

Schreibt beim Überschreiben in einer abgeleiteten Klasse das Attribut mit dem angegebenen Präfix, lokalen Namen, Namespace-URI und Wert.

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

public void WriteAttributeString (
	string prefix,
	string localName,
	string ns,
	string value
)
public void WriteAttributeString (
	String prefix, 
	String localName, 
	String ns, 
	String value
)
public function WriteAttributeString (
	prefix : String, 
	localName : String, 
	ns : String, 
	value : String
)

Parameter

prefix

Das Namespacepräfix des Attributs.

localName

Der lokale Name des Attributs.

ns

Der Namespace-URI dieses Attributs.

value

Der Wert des Attributs.

AusnahmetypBedingung

InvalidOperationException

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

ArgumentException

Der xml:space-Attributwert oder der xml:lang-Attributwert ist ungültig.

Diese Methode schreibt das Attribut mit einem benutzerdefinierten Namespacepräfix und ordnet es dem angegebenen Namespace zu. Wenn das Präfix "xmlns" ist, behandelt diese Methode dies außerdem als Namespacedeklaration und ordnet das deklarierte Präfix dem im angegebenen Attributwert bereitgestellten Namespace-URI zu. In diesem Fall kann das ns-Argument NULL (Nothing in Visual Basic) sein.

WriteAttributeString führt Folgendes aus:

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

  • Beim Schreiben eines xml:space-Attributs überprüft der Writer die Gültigkeit des Attributwerts. (Gültige Werte sind preserve und default.)

  • Beim Schreiben eines xml:lang-Attributs überprüft der Writer nicht die Gültigkeit des Attributwerts gemäß der W3C-Empfehlung für XML, Version 1.0.

Im folgenden Beispiel wird mithilfe der WriteAttributeString-Methode eine Namespacedeklaration geschrieben.

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

  }
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.