XmlWriter.WriteStartAttribute Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Přetížení

Name	Description
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 naleznete v tématu WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

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

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 kódování výstupu. Pokud je například kódování výstupu ASCII, měli byste pro názvy elementů a atributů použít pouze znaky z rozsahu 0 až 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapisovat do vyrovnávací paměti. Tyto znaky jsou řídicími znaky odkazy na entity znaků, pokud je to možné (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech prvků a atributů, komentářích, pokynech ke zpracování nebo částech CDATA.

InvalidOperationException

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

Poznámky

Tato metoda umožňuje napsat hodnotu pomocí více metod zápisu.

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

WriteStartAttribute(String)

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

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 zpráva "Asynchronní operace už probíhá".

EncoderFallbackException

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

Poznámky

Tato metoda umožňuje napsat hodnotu pomocí více metod zápisu.

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

WriteStartAttribute(String, String)

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

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 kódování výstupu. Pokud je například kódování výstupu ASCII, měli byste pro názvy elementů a atributů použít pouze znaky z rozsahu 0 až 127. Neplatný znak může být v argumentu této metody nebo v argumentu předchozích metod, které byly zapisovat do vyrovnávací paměti. Tyto znaky jsou řídicími znaky odkazy na entity znaků, pokud je to možné (například v textových uzlech nebo hodnotách atributů). Odkaz na entitu znaků však není povolen v názvech prvků a atributů, komentářích, pokynech ke zpracování nebo částech CDATA.

InvalidOperationException

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

Příklady

Podívejte se XmlTextWriter.WriteStartAttribute na příklad použití této metody.

Poznámky

Jedná se o pokročilejší verzi WriteAttributeString , která umožňuje napsat hodnotu atributu pomocí více metod zápisu, například WriteString, WriteQualifiedNamea tak dále.

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

Viz také

• WriteEndAttribute()