Sdílet prostřednictvím


XmlWriter.WriteStartAttribute Metoda

Definice

Při přepsání v odvozené třídě zapíše začátek atributu.

Přetížení

WriteStartAttribute(String, String, String)

Při přepsání v odvozené třídě zapíše začátek atributu se zadanou předponou, místním názvem a identifikátorem URI oboru názvů.

WriteStartAttribute(String)

Zapíše začátek atributu se zadaným místním názvem.

WriteStartAttribute(String, String)

Zapíše začátek atributu se zadaným místním názvem a identifikátorem URI oboru názvů.

Poznámky

Asynchronní verzi této metody najdete v tématu WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Při přepsání v odvozené třídě zapíše začátek atributu se zadanou předponou, místním názvem a identifikátorem URI oboru názvů.

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

Předpona oboru názvů atributu.

localName
String

Místní název atributu.

ns
String

Identifikátor URI oboru názvů pro atribut.

Výjimky

Ve vyrovnávací paměti je znak, který je platným znakem XML, ale není platný pro výstupní kódování. Pokud je například výstupní kódování ASCII, měli byste pro názvy elementů a atributů používat pouze znaky v rozsahu od 0 do 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapsány do vyrovnávací paměti. Pokud je to možné, tyto znaky jsou řídicími znaky odkazy na entitu znaků (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech elementů a atributů, komentářích, pokynech pro zpracování nebo oddílech CDATA.

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Poznámky

Tato metoda umožňuje zapsat hodnotu pomocí více metod Write.

Asynchronní verzi této metody najdete v tématu WriteStartAttributeAsync.

Platí pro

WriteStartAttribute(String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Zapíše začátek atributu se zadaným místním názvem.

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

Místní název atributu.

Výjimky

Spisovatel je zavřený.

-nebo-

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Ve vyrovnávací paměti je znak, který je platným znakem XML, ale není platný pro výstupní kódování. Pokud je například výstupní kódování ASCII, měli byste pro názvy elementů a atributů používat pouze znaky v rozsahu od 0 do 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapsány do vyrovnávací paměti. Pokud je to možné, tyto znaky jsou řídicími znaky odkazy na entitu znaků (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech elementů a atributů, komentářích, pokynech pro zpracování nebo oddílech CDATA.

Poznámky

Tato metoda umožňuje zapsat hodnotu pomocí více metod Write.

Asynchronní verzi této metody najdete v tématu WriteStartAttributeAsync.

Platí pro

WriteStartAttribute(String, String)

Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs
Zdroj:
XmlWriter.cs

Zapíše začátek atributu se zadaným místním názvem a identifikátorem URI oboru názvů.

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

Místní název atributu.

ns
String

Identifikátor URI oboru názvů atributu.

Výjimky

Ve vyrovnávací paměti je znak, který je platným znakem XML, ale není platný pro výstupní kódování. Pokud je například výstupní kódování ASCII, měli byste pro názvy elementů a atributů používat pouze znaky v rozsahu od 0 do 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapsány do vyrovnávací paměti. Pokud je to možné, tyto znaky jsou řídicími znaky odkazy na entitu znaků (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech elementů a atributů, komentářích, pokynech pro zpracování nebo oddílech CDATA.

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda . V tomto případě InvalidOperationException je vyvolán se zprávou "Asynchronní operace již probíhá.".

Příklady

Příklad použití této metody najdete v tématu XmlTextWriter.WriteStartAttribute .

Poznámky

Toto je pokročilejší verze nástroje WriteAttributeString , která umožňuje napsat hodnotu atributu pomocí více metod zápisu, jako WriteStringjsou , WriteQualifiedNamea tak dále.

Asynchronní verzi této metody najdete v tématu WriteStartAttributeAsync.

Viz také

Platí pro