XmlWriter.WriteStartAttribute Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Schreibt beim Überschreiben in einer abgeleiteten Klasse den Anfang eines Attributs.

Überlädt

WriteStartAttribute(String, String, String)	Schreibt beim Überschreiben in einer abgeleiteten Klasse den Anfang eines Attributs mit dem angegebenen Präfix, dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.
WriteStartAttribute(String)	Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen.
WriteStartAttribute(String, String)	Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

Hinweise

Die asynchrone Version dieser Methode finden Sie unter WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Source:

XmlWriter.cs

Schreibt beim Überschreiben in einer abgeleiteten Klasse den Anfang eines Attributs mit dem angegebenen Präfix, dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

public:
 abstract void WriteStartAttribute(System::String ^ prefix, System::String ^ localName, System::String ^ ns);

public abstract void WriteStartAttribute (string? prefix, string localName, string? ns);

abstract member WriteStartAttribute : string * string * string -> unit

Public MustOverride Sub WriteStartAttribute (prefix As String, localName As String, ns As String)

Parameter

prefix

String

Das Namespacepräfix des Attributs.

localName

String

Der lokale Name des Attributs.

ns

String

Der Namespace-URI für das Attribut.

Ausnahmen

EncoderFallbackException

Es gibt ein Zeichen im Puffer, das ein gültiges XML-Zeichen ist, aber nicht gültig für die Ausgabecodierung ist. Wenn die Ausgabecodierung z. B. ASCII ist, sollten Sie nur Zeichen im Bereich von 0 bis 127 für Element- und Attributnamen verwenden. Das ungültige Zeichen kann sich im Argument dieser Methode oder in einem Argument von vorherigen Methoden befinden, die in den Puffer geschrieben haben. Solche Zeichen werden wenn möglich von Zeichenentitätsverweisen maskiert (z. B., in Textknoten oder Attributwerten). Der Zeichenentitätsverweis ist jedoch nicht in Element- und Attributnamen, Kommentaren, Verarbeitungsanweisungen oder CDATA-Abschnitten zugelassen.

InvalidOperationException

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

Mit dieser Methode können Sie einen Wert mit mehreren Write-Methoden schreiben.

Die asynchrone Version dieser Methode finden Sie unter WriteStartAttributeAsync.

WriteStartAttribute(String)

Source:

XmlWriter.cs

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen.

public:
 void WriteStartAttribute(System::String ^ localName);

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

Parameter

localName

String

Der lokale Name des Attributs.

Ausnahmen

InvalidOperationException

Der Writer ist geschlossen.

- oder -

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

EncoderFallbackException

Es gibt ein Zeichen im Puffer, das ein gültiges XML-Zeichen ist, aber nicht gültig für die Ausgabecodierung ist. Wenn die Ausgabecodierung z. B. ASCII ist, sollten Sie nur Zeichen im Bereich von 0 bis 127 für Element- und Attributnamen verwenden. Das ungültige Zeichen kann sich im Argument dieser Methode oder in einem Argument von vorherigen Methoden befinden, die in den Puffer geschrieben haben. Solche Zeichen werden wenn möglich von Zeichenentitätsverweisen maskiert (z. B., in Textknoten oder Attributwerten). Der Zeichenentitätsverweis ist jedoch nicht in Element- und Attributnamen, Kommentaren, Verarbeitungsanweisungen oder CDATA-Abschnitten zugelassen.

Hinweise

Mit dieser Methode können Sie einen Wert mit mehreren Write-Methoden schreiben.

Die asynchrone Version dieser Methode finden Sie unter WriteStartAttributeAsync.

WriteStartAttribute(String, String)

Source:

XmlWriter.cs

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen und dem angegebenen Namespace-URI.

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

public void WriteStartAttribute (string localName, string? ns);

member this.WriteStartAttribute : string * string -> unit

Public Sub WriteStartAttribute (localName As String, ns As String)

Parameter

localName

String

Der lokale Name des Attributs.

ns

String

Der Namespace-URI dieses Attributs.

Ausnahmen

EncoderFallbackException

Es gibt ein Zeichen im Puffer, das ein gültiges XML-Zeichen ist, aber nicht gültig für die Ausgabecodierung ist. Wenn die Ausgabecodierung z. B. ASCII ist, sollten Sie nur Zeichen im Bereich von 0 bis 127 für Element- und Attributnamen verwenden. Das ungültige Zeichen kann sich im Argument dieser Methode oder in einem Argument von vorherigen Methoden befinden, die in den Puffer geschrieben haben. Solche Zeichen werden wenn möglich von Zeichenentitätsverweisen maskiert (z. B., in Textknoten oder Attributwerten). Der Zeichenentitätsverweis ist jedoch nicht in Element- und Attributnamen, Kommentaren, Verarbeitungsanweisungen oder CDATA-Abschnitten zugelassen.

InvalidOperationException

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Ein Beispiel für die Verwendung dieser Methode finden Sie XmlTextWriter.WriteStartAttribute unter.

Hinweise

Dies ist eine erweiterte Version von, mit der WriteAttributeString Sie einen Attributwert mit mehreren Schreibmethoden wie WriteString, WriteQualifiedNameusw. schreiben können.

Die asynchrone Version dieser Methode finden Sie unter WriteStartAttributeAsync.

Weitere Informationen

• WriteEndAttribute()