XmlWriter.WriteStartAttribute Methode

Definition

Wenn eine abgeleitete Klasse überschrieben wird, wird der Anfang eines Attributs geschrieben.

Überlädt

Name Beschreibung
WriteStartAttribute(String, String, String)

Wenn eine abgeleitete Klasse überschrieben wird, wird der Anfang eines Attributs mit dem angegebenen Präfix, dem lokalen Namen und dem Namespace-URI geschrieben.

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

Wenn eine abgeleitete Klasse überschrieben wird, wird der Anfang eines Attributs mit dem angegebenen Präfix, dem lokalen Namen und dem Namespace-URI geschrieben.

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 für die Ausgabecodierung nicht gültig ist. Wenn die Ausgabecodierung beispielsweise ASCII ist, sollten Sie nur Zeichen aus dem 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 früherer Methoden befinden, die in den Puffer geschrieben wurden. Solche Zeichen werden nach Möglichkeit durch Zeichenentitätsverweise (z. B. in Textknoten oder Attributwerten) escapet. Der Verweis auf die Zeichenentität ist jedoch in Element- und Attributnamen, Kommentaren, Verarbeitungsanweisungen oder CDATA-Abschnitten nicht zulässig.

Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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
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 Autor ist geschlossen.

-oder-

Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Es gibt ein Zeichen im Puffer, das ein gültiges XML-Zeichen ist, aber für die Ausgabecodierung nicht gültig ist. Wenn die Ausgabecodierung beispielsweise ASCII ist, sollten Sie nur Zeichen aus dem 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 früherer Methoden befinden, die in den Puffer geschrieben wurden. Solche Zeichen werden nach Möglichkeit durch Zeichenentitätsverweise (z. B. in Textknoten oder Attributwerten) escapet. Der Verweis auf die Zeichenentität ist jedoch in Element- und Attributnamen, Kommentaren, Verarbeitungsanweisungen oder CDATA-Abschnitten nicht zulässig.

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

Schreibt den Anfang eines Attributs mit dem angegebenen lokalen Namen und 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 des Attributs.

Ausnahmen

Es gibt ein Zeichen im Puffer, das ein gültiges XML-Zeichen ist, aber für die Ausgabecodierung nicht gültig ist. Wenn die Ausgabecodierung beispielsweise ASCII ist, sollten Sie nur Zeichen aus dem 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 früherer Methoden befinden, die in den Puffer geschrieben wurden. Solche Zeichen werden nach Möglichkeit durch Zeichenentitätsverweise (z. B. in Textknoten oder Attributwerten) escapet. Der Verweis auf die Zeichenentität ist jedoch in Element- und Attributnamen, Kommentaren, Verarbeitungsanweisungen oder CDATA-Abschnitten nicht zulässig.

Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.

Beispiele

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

Hinweise

Dies ist eine komplexere Version, mit der WriteAttributeString Sie einen Attributwert mit mehreren Schreibmethoden schreiben können, z WriteString. B. , WriteQualifiedNameusw.

Die asynchrone Version dieser Methode finden Sie unter WriteStartAttributeAsync.

Weitere Informationen

Gilt für: