Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo XmlWriter.WriteAttributeString (String, String, String, String)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public void WriteAttributeString(
	string prefix,
	string localName,
	string ns,
	string value
)

Parametri

prefix
Type: System.String

Prefisso dello spazio dei nomi dell'attributo.

localName
Type: System.String

Nome locale dell'attributo.

ns
Type: System.String

URI dello spazio dei nomi dell'attributo.

value
Type: System.String

Valore dell'attributo.

Exception Condition
InvalidOperationException

Lo stato del writer non è WriteState.Element o writer viene chiuso.

ArgumentException

Il xml:space o xml:lang valore di attributo non è valido.

XmlException

Il localName o ns è null.

InvalidOperationException

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

Questo metodo scrive l'attributo con un prefisso di spazio dei nomi definito utente e lo associa allo spazio dei nomi specificato. Se il prefisso "xmlns" quindi questo metodo anche considerato come una dichiarazione dello spazio dei nomi e associa il prefisso dichiarato con lo spazio dei nomi che URI specificato nel valore dell'attributo specificato. In questo caso il ns argomento può essere null.

WriteAttributeString effettua le operazioni seguenti:

  • Se il valore dell'attributo include virgolette doppie o singole, vengono sostituiti con " e ' rispettivamente.

  • Se la scrittura di un xml:space attributo, il writer verifica il valore dell'attributo è valido. (I valori validi sono preserve o default.)

  • Se la scrittura di un xml:lang attributo, il writer non verifica che il valore dell'attributo è valido in base alla raccomandazione W3C XML 1.0.

Per la versione asincrona del metodo, vedere WriteAttributeStringAsync.

Nell'esempio seguente viene utilizzata la WriteAttributeString metodo per scrivere una dichiarazione dello spazio dei nomi.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

     // Write the root element.
     writer.WriteStartElement("book");

     // Write the xmlns:bk="urn:book" namespace declaration.
     writer.WriteAttributeString("xmlns","bk", null,"urn:book");

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

     // Write the close tag for the root element.
     writer.WriteEndElement();

     // Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();  

  }
}

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: