XmlWriter.WriteStartAttribute Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando ne viene eseguito l'override in una classe derivata, scrive l'inizio di un attributo.

Overload

WriteStartAttribute(String, String, String)	Quando ne viene eseguito l'override in una classe derivata, scrive l'inizio di un attributo con il prefisso, il nome locale e l'URI dello spazio dei nomi specificati.
WriteStartAttribute(String)	Scrive l'inizio di un attributo con il nome locale specificato.
WriteStartAttribute(String, String)	Scrive l'inizio di un attributo con il nome locale e l'URI dello spazio dei nomi specificati.

Commenti

Per la versione asincrona di questo metodo, vedere WriteStartAttributeAsync.

WriteStartAttribute(String, String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive l'inizio di un attributo con il prefisso, il nome locale e l'URI dello spazio dei nomi specificati.

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)

Parametri

prefix

String

Prefisso dello spazio dei nomi dell'attributo.

localName

String

Nome locale dell'attributo.

ns

String

URI dello spazio dei nomi dell'attributo.

Eccezioni

EncoderFallbackException

Nel buffer è presente un carattere XML valido che non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è necessario utilizzare solo caratteri dell'intervallo compreso tra 0 e 127 per nomi di elemento e di attributo. Il carattere non valido potrebbe essere nell'argomento di questo metodo o in un argomento di metodi precedenti che stanno scrivendo nel buffer. Tali caratteri vengono preceduti, quando possibile, da caratteri di escape costituiti da riferimenti a un'entità carattere, ad esempio in nodi di testo o valori di attributo. Tuttavia, il riferimento a un'entità di caratteri non è consentita in nomi di elemento e di attributo, commenti, istruzioni di elaborazione o sezioni CDATA.

InvalidOperationException

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Commenti

Questo metodo consente di scrivere un valore usando più metodi write.

Per la versione asincrona di questo metodo, vedere WriteStartAttributeAsync.

WriteStartAttribute(String)

Scrive l'inizio di un attributo con il nome locale specificato.

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

public void WriteStartAttribute (string localName);

member this.WriteStartAttribute : string -> unit

Public Sub WriteStartAttribute (localName As String)

Parametri

localName

String

Nome locale dell'attributo.

Eccezioni

InvalidOperationException

Il writer viene chiuso.

-oppure-

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

EncoderFallbackException

Nel buffer è presente un carattere XML valido che non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è necessario utilizzare solo caratteri dell'intervallo compreso tra 0 e 127 per nomi di elemento e di attributo. Il carattere non valido potrebbe essere nell'argomento di questo metodo o in un argomento di metodi precedenti che stanno scrivendo nel buffer. Tali caratteri vengono preceduti, quando possibile, da caratteri di escape costituiti da riferimenti a un'entità carattere, ad esempio in nodi di testo o valori di attributo. Tuttavia, il riferimento a un'entità di caratteri non è consentita in nomi di elemento e di attributo, commenti, istruzioni di elaborazione o sezioni CDATA.

Commenti

Questo metodo consente di scrivere un valore usando più metodi write.

Per la versione asincrona di questo metodo, vedere WriteStartAttributeAsync.

WriteStartAttribute(String, String)

Scrive l'inizio di un attributo con il nome locale e l'URI dello spazio dei nomi specificati.

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)

Parametri

localName

String

Nome locale dell'attributo.

ns

String

URI dello spazio dei nomi dell'attributo.

Eccezioni

EncoderFallbackException

Nel buffer è presente un carattere XML valido che non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è necessario utilizzare solo caratteri dell'intervallo compreso tra 0 e 127 per nomi di elemento e di attributo. Il carattere non valido potrebbe essere nell'argomento di questo metodo o in un argomento di metodi precedenti che stanno scrivendo nel buffer. Tali caratteri vengono preceduti, quando possibile, da caratteri di escape costituiti da riferimenti a un'entità carattere, ad esempio in nodi di testo o valori di attributo. Tuttavia, il riferimento a un'entità di caratteri non è consentita in nomi di elemento e di attributo, commenti, istruzioni di elaborazione o sezioni CDATA.

InvalidOperationException

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Esempio

Vedere XmlTextWriter.WriteStartAttribute per un esempio usando questo metodo.

Commenti

Si tratta di una versione più avanzata di che consente di scrivere un valore di attributo usando più metodi di WriteAttributeString scrittura, ad esempio WriteString, WriteQualifiedNamee così via.

Per la versione asincrona di questo metodo, vedere WriteStartAttributeAsync.

Vedi anche

• WriteEndAttribute()