XmlWriter.WriteStartAttribute Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

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)

Source:

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

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

EncoderFallbackException

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.

InvalidOperationException

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.

WriteStartAttribute(String)

Source:

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

InvalidOperationException

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

EncoderFallbackException

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.

WriteStartAttribute(String, String)

Source:

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

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

EncoderFallbackException

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.

InvalidOperationException

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é

• WriteEndAttribute()