XmlWriter.WriteStartAttribute Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Po zastąpieniu w klasie pochodnej zapisuje początek atrybutu.

Przeciążenia

WriteStartAttribute(String, String, String)	Po zastąpieniu w klasie pochodnej zapisuje początek atrybutu z określonym prefiksem, nazwą lokalną i identyfikatorem URI przestrzeni nazw.
WriteStartAttribute(String)	Zapisuje początek atrybutu o określonej nazwie lokalnej.
WriteStartAttribute(String, String)	Zapisuje początek atrybutu o określonej lokalnej nazwie i identyfikatorze URI przestrzeni nazw.

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Po zastąpieniu w klasie pochodnej zapisuje początek atrybutu z określonym prefiksem, nazwą lokalną i identyfikatorem URI przestrzeni nazw.

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)

Parametry

prefix

String

Prefiks przestrzeni nazw atrybutu.

localName

String

Lokalna nazwa atrybutu.

ns

String

Identyfikator URI przestrzeni nazw dla atrybutu.

Wyjątki

EncoderFallbackException

W buforze znajduje się znak, który jest prawidłowym znakiem XML, ale nie jest prawidłowy dla kodowania danych wyjściowych. Jeśli na przykład kodowanie wyjściowe to ASCII, należy używać tylko znaków z zakresu od 0 do 127 dla nazw elementów i atrybutów. Nieprawidłowy znak może być argumentem tej metody lub argumentem poprzednich metod zapisywanych w buforze. Takie znaki są uciekane przez odwołania do jednostki znaków, gdy jest to możliwe (na przykład w węzłach tekstowych lub wartościach atrybutów). Odwołanie do jednostki znaku nie jest jednak dozwolone w nazwach elementów i atrybutów, komentarzach, instrukcjach przetwarzania lub sekcjach CDATA.

InvalidOperationException

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda umożliwia pisanie wartości przy użyciu wielu metod zapisu.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartAttributeAsync.

WriteStartAttribute(String)

Zapisuje początek atrybutu o określonej nazwie lokalnej.

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

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

Parametry

localName

String

Lokalna nazwa atrybutu.

Wyjątki

InvalidOperationException

Pisarz jest zamknięty.

-lub-

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

EncoderFallbackException

W buforze znajduje się znak, który jest prawidłowym znakiem XML, ale nie jest prawidłowy dla kodowania danych wyjściowych. Jeśli na przykład kodowanie wyjściowe to ASCII, należy używać tylko znaków z zakresu od 0 do 127 dla nazw elementów i atrybutów. Nieprawidłowy znak może być argumentem tej metody lub argumentem poprzednich metod zapisywanych w buforze. Takie znaki są uciekane przez odwołania do jednostki znaków, gdy jest to możliwe (na przykład w węzłach tekstowych lub wartościach atrybutów). Odwołanie do jednostki znaku nie jest jednak dozwolone w nazwach elementów i atrybutów, komentarzach, instrukcjach przetwarzania lub sekcjach CDATA.

Uwagi

Ta metoda umożliwia pisanie wartości przy użyciu wielu metod zapisu.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartAttributeAsync.

WriteStartAttribute(String, String)

Zapisuje początek atrybutu o określonej lokalnej nazwie i identyfikatorze URI przestrzeni nazw.

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)

Parametry

localName

String

Lokalna nazwa atrybutu.

ns

String

Identyfikator URI przestrzeni nazw atrybutu.

Wyjątki

EncoderFallbackException

W buforze znajduje się znak, który jest prawidłowym znakiem XML, ale nie jest prawidłowy dla kodowania danych wyjściowych. Jeśli na przykład kodowanie wyjściowe to ASCII, należy używać tylko znaków z zakresu od 0 do 127 dla nazw elementów i atrybutów. Nieprawidłowy znak może być argumentem tej metody lub argumentem poprzednich metod zapisywanych w buforze. Takie znaki są uciekane przez odwołania do jednostki znaków, gdy jest to możliwe (na przykład w węzłach tekstowych lub wartościach atrybutów). Odwołanie do jednostki znaku nie jest jednak dozwolone w nazwach elementów i atrybutów, komentarzach, instrukcjach przetwarzania lub sekcjach CDATA.

InvalidOperationException

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Przykłady

Zobacz XmlTextWriter.WriteStartAttribute przykład użycia tej metody.

Uwagi

Jest to bardziej zaawansowana wersja, która umożliwia pisanie wartości atrybutu WriteAttributeString przy użyciu wielu metod zapisu, takich jak WriteString, WriteQualifiedNamei tak dalej.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartAttributeAsync.

Zobacz też

• WriteEndAttribute()