Udostępnij za pośrednictwem


XmlWriter.WriteStartAttribute Metoda

Definicja

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)

Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs

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

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.

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.

Dotyczy

WriteStartAttribute(String)

Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs

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

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".

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.

Dotyczy

WriteStartAttribute(String, String)

Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs
Źródło:
XmlWriter.cs

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

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.

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ż

Dotyczy