Teilen über


XmlWriter.WriteStartAttribute Methode

Definition

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)

Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs
Quelle:
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);
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

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.

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.

Gilt für:

WriteStartAttribute(String)

Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs
Quelle:
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

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.

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.

Gilt für:

WriteStartAttribute(String, String)

Quelle:
XmlWriter.cs
Quelle:
XmlWriter.cs
Quelle:
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);
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

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.

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

Gilt für: