XmlWriter.WriteStartAttribute Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Quando sottoposto a override in una classe derivata, scrive l'inizio di un attributo.
Overload
| Nome | Descrizione |
|---|---|
| WriteStartAttribute(String, String, String) |
Quando sottoposto a 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 sottoposto a 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);abstract member WriteStartAttribute : string * string * string -> unitPublic 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 per l'attributo.
Eccezioni
È presente un carattere nel buffer che è un carattere XML valido, ma non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è consigliabile usare solo i caratteri compresi tra 0 e 127 per i nomi di elementi e attributi. Il carattere non valido potrebbe trovarsi nell'argomento di questo metodo o in un argomento di metodi precedenti che stavano scrivendo nel buffer. Tali caratteri vengono preceduti da un carattere di escape per i riferimenti all'entità carattere, ad esempio nei nodi di testo o nei valori degli attributi. Tuttavia, il riferimento all'entità carattere non è consentito nelle sezioni di elementi e attributi, commenti, istruzioni di elaborazione o CDATA.
È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
Commenti
Questo metodo consente di scrivere un valore usando più metodi di scrittura.
Per la versione asincrona di questo metodo, vedere WriteStartAttributeAsync.
Si applica a
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 -> unitPublic Sub WriteStartAttribute (localName As String)Parametri
- localName
- String
Nome locale dell'attributo.
Eccezioni
Il writer è chiuso.
oppure
È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
È presente un carattere nel buffer che è un carattere XML valido, ma non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è consigliabile usare solo i caratteri compresi tra 0 e 127 per i nomi di elementi e attributi. Il carattere non valido potrebbe trovarsi nell'argomento di questo metodo o in un argomento di metodi precedenti che stavano scrivendo nel buffer. Tali caratteri vengono preceduti da un carattere di escape per i riferimenti all'entità carattere, ad esempio nei nodi di testo o nei valori degli attributi. Tuttavia, il riferimento all'entità carattere non è consentito nelle sezioni di elementi e attributi, commenti, istruzioni di elaborazione o CDATA.
Commenti
Questo metodo consente di scrivere un valore usando più metodi di scrittura.
Per la versione asincrona di questo metodo, vedere WriteStartAttributeAsync.
Si applica a
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);member this.WriteStartAttribute : string * string -> unitPublic 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
È presente un carattere nel buffer che è un carattere XML valido, ma non è valido per la codifica di output. Ad esempio, se la codifica di output è ASCII, è consigliabile usare solo i caratteri compresi tra 0 e 127 per i nomi di elementi e attributi. Il carattere non valido potrebbe trovarsi nell'argomento di questo metodo o in un argomento di metodi precedenti che stavano scrivendo nel buffer. Tali caratteri vengono preceduti da un carattere di escape per i riferimenti all'entità carattere, ad esempio nei nodi di testo o nei valori degli attributi. Tuttavia, il riferimento all'entità carattere non è consentito nelle sezioni di elementi e attributi, commenti, istruzioni di elaborazione o CDATA.
È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
Esempio
Vedere XmlTextWriter.WriteStartAttribute per un esempio relativo all'uso di 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.