XmlWriter Classe

Definizione

Rappresenta un writer che fornisce un modo veloce, non in cache e di tipo forward-only per generare flussi o i file contenenti dati XML.Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data.

public ref class XmlWriter abstract : IDisposable
public abstract class XmlWriter : IDisposable
type XmlWriter = class
    interface IDisposable
Public MustInherit Class XmlWriter
Implements IDisposable
Ereditarietà
XmlWriter
Derivato
Implementazioni

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare l'API asincrona per generare codice XML.The following example code shows how to use the asynchronous API to generate XML.

async Task TestWriter(Stream stream)   
{  
    XmlWriterSettings settings = new XmlWriterSettings();  
    settings.Async = true;  
  
    using (XmlWriter writer = XmlWriter.Create(stream, settings)) {  
        await writer.WriteStartElementAsync("pf", "root", "http://ns");  
        await writer.WriteStartElementAsync(null, "sub", null);  
        await writer.WriteAttributeStringAsync(null, "att", null, "val");  
        await writer.WriteStringAsync("text");  
        await writer.WriteEndElementAsync();  
        await writer.WriteProcessingInstructionAsync("pName", "pValue");  
        await writer.WriteCommentAsync("cValue");  
        await writer.WriteCDataAsync("cdata value");  
        await writer.WriteEndElementAsync();  
        await writer.FlushAsync();  
    }  
}  

Commenti

La classe XmlWriter scrive i dati XML in un flusso, in un file, in un lettore di testo o in una stringa.The XmlWriter class writes XML data to a stream, file, text reader, or string. Supporta la W3C Extensible Markup Language (XML) 1,0 (quarta edizione) e gli spazi dei nomi in XML 1,0 (terza edizione) consigli.It supports the W3C Extensible Markup Language (XML) 1.0 (fourth edition) and Namespaces in XML 1.0 (third edition) recommendations.

I membri della classe XmlWriter consentono di:The members of the XmlWriter class enable you to:

  • Verificare che i caratteri siano caratteri XML validi e che i nomi di attributi ed elementi siano nomi XML validi.Verify that the characters are legal XML characters and that element and attribute names are valid XML names.

  • Verificare che il documento XML sia in formato corretto.Verify that the XML document is well-formed.

  • Codificare i byte binari come base64 o BinHex e scrivere il testo risultante.Encode binary bytes as Base64 or BinHex, and write out the resulting text.

  • Passare i valori usando Common Language Runtime tipi anziché le stringhe, per evitare di dover eseguire manualmente le conversioni dei valori.Pass values by using common language runtime types instead of strings, to avoid having to manually perform value conversions.

  • Scrivere più documenti in un unico flusso di output.Write multiple documents to one output stream.

  • Scrivere nomi validi, qualificati e token del nome.Write valid names, qualified names, and name tokens.

Contenuto della sezione:In this section:

Creazione di un writer XML Creating an XML writer
Specifica del formato di output Specifying the output format
della conformità dei datiData conformance
Scrittura di elementi Writing elements
Scrittura di attributi Writing attributes
Gestione degli spazi dei nomi Handling namespaces
Scrittura di dati tipizzati Writing typed data
Chiusura del writer XML Closing the XML writer
di programmazione asincronaAsynchronous programming
Considerazioni sulla sicurezzaSecurity considerations

Creazione di un writer XMLCreating an XML writer

Per creare un'istanza di XmlWriter, utilizzare il metodo XmlWriter.Create.To create an XmlWriter instance, use the XmlWriter.Create method. Per specificare il set di funzionalità che si desidera abilitare nel writer XML, passare un XmlWriterSettings al metodo Create.To specify the set of features you want to enable on the XML writer, pass an XmlWriterSettings to the Create method. In caso contrario, vengono utilizzate le impostazioni predefinite.Otherwise, default settings are used. Per informazioni dettagliate, vedere le pagine di riferimento Create.See the Create reference pages for details.

Specifica del formato di outputSpecifying the output format

La classe XmlWriterSettings include diverse proprietà che controllano il modo in cui viene formattato l'output del XmlWriter:The XmlWriterSettings class includes several properties that control how XmlWriter output is formatted:

ProprietàProperty DescriptionDescription
Encoding Specifica la codifica di testo da utilizzare.Specifies the text encoding to use. Il valore predefinito è Encoding.UTF8.The default is Encoding.UTF8.
Indent Indica se impostare il rientro per gli elementi.Indicates whether to indent elements. Il valore predefinito è false (nessun rientro).The default is false (no indentation).
IndentChars Specifica la stringa di caratteri da utilizzare quando si esegue il rientro.Specifies the character string to use when indenting. Il valore predefinito è due spazi.The default is two spaces.
NewLineChars Specifica la stringa di caratteri da utilizzare per le interruzioni di riga.Specifies the character string to use for line breaks. Il valore predefinito è \r\n (ritorno a capo, avanzamento riga).The default is \r\n (carriage return, line feed).
NewLineHandling Specifica come gestire i caratteri di nuova riga.Specifies how to handle newline characters.
NewLineOnAttributes Indica se scrivere attributi in una nuova riga.Indicates whether to write attributes on a new line. Indent deve essere impostato su true quando si utilizza questa proprietà.Indent should be set to true when using this property. Il valore predefinito è false.The default is false.
OmitXmlDeclaration Indica se scrivere una dichiarazione XML.Indicates whether to write an XML declaration. Il valore predefinito è false.The default is false.

Le proprietà Indent e IndentChars consentono di controllare il modo in cui vengono formattati gli spazi vuoti non significativi.The Indent and IndentChars properties control how insignificant white space is formatted. Ad esempio, per rientrare i nodi elemento:For example, to indent element nodes:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.IndentChars = "\t";
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.IndentChars = vbTab
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Usare il NewLineOnAttributes per scrivere ogni attributo in una nuova riga con un livello aggiuntivo di rientro:Use the NewLineOnAttributes to write each attribute on a new line with one extra level of indentation:

XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.NewLineOnAttributes = true;
XmlWriter writer = XmlWriter.Create("books.xml", settings);
Dim settings As New XmlWriterSettings()
settings.Indent = True
settings.NewLineOnAttributes = True
Dim writer As XmlWriter = XmlWriter.Create("books.xml", settings)

Conformità dei datiData conformance

Un writer XML utilizza due proprietà della classe XmlWriterSettings per verificare la conformità dei dati:An XML writer uses two properties from the XmlWriterSettings class to check for data conformance:

  • La proprietà CheckCharacters indica al writer XML di controllare i caratteri e generare un'eccezione XmlException se i caratteri non rientrano nell'intervallo valido, come definito da W3C.The CheckCharacters property instructs the XML writer to check characters and throw an XmlException exception if any characters are outside the legal range, as defined by the W3C.

  • La proprietà ConformanceLevel configura il writer XML per verificare che il flusso scritto sia conforme alle regole per un documento XML 1,0 ben formato o un frammento di documento, come definito da W3C.The ConformanceLevel property configures the XML writer to check that the stream being written complies with the rules for a well-formed XML 1.0 document or document fragment, as defined by the W3C. Nella tabella seguente sono descritti i tre livelli di conformità.The three conformance levels are described in the following table. Il valore predefinito è Document.The default is Document. Per informazioni dettagliate, vedere la proprietà XmlWriterSettings.ConformanceLevel e l'enumerazione System.Xml.ConformanceLevel.For details, see the XmlWriterSettings.ConformanceLevel property and the System.Xml.ConformanceLevel enumeration.

    LivelloLevel DescriptionDescription
    Document L'output XML è conforme alle regole per un documento XML 1,0 ben formato e può essere elaborato da qualsiasi processore conforme.The XML output conforms to the rules for a well-formed XML 1.0 document and can be processed by any conforming processor.
    Fragment L'output XML è conforme alle regole per un frammento di documento XML 1,0 ben formato.The XML output conforms to the rules for a well-formed XML 1.0 document fragment.
    Auto Il writer XML determina il livello di controllo della conformità da applicare (documento o frammento) in base ai dati in ingresso.The XML writer determines which level of conformation checking to apply (document or fragment) based on the incoming data.

Scrittura di elementiWriting elements

Per scrivere nodi di elementi, è possibile usare i metodi di XmlWriter seguenti.You can use the following XmlWriter methods to write element nodes. Per esempi, vedere i metodi elencati.For examples, see the methods listed.

UsaUse ATo
WriteElementString Scrivere un intero nodo elemento, incluso un valore stringa.Write an entire element node, including a string value.
WriteStartElement Per scrivere un valore di elemento usando più chiamate al metodo.To write an element value by using multiple method calls. Ad esempio, è possibile chiamare WriteValue per scrivere un valore tipizzato, WriteCharEntity per scrivere un'entità di carattere, WriteAttributeString per scrivere un attributo, oppure è possibile scrivere un elemento figlio.For example, you can call WriteValue to write a typed value, WriteCharEntity to write a character entity, WriteAttributeString to write an attribute, or you can write a child element. Si tratta di una versione più sofisticata del metodo WriteElementString.This is a more sophisticated version of the WriteElementString method.

Per chiudere l'elemento, chiamare il metodo WriteEndElement o WriteFullEndElement.To close the element, you call the WriteEndElement or WriteFullEndElement method.
WriteNode Per copiare un nodo elemento trovato nella posizione corrente di un oggetto XmlReader o XPathNavigator.To copy an element node found at the current position of an XmlReader or XPathNavigator object. Quando viene chiamato, il metodo copia tutto dall'oggetto di origine all'istanza XmlWriter.When called, it copies everything from the source object to the XmlWriter instance.

Scrittura di attributiWriting attributes

Per scrivere attributi nei nodi degli elementi, è possibile usare i metodi di XmlWriter seguenti.You can use the following XmlWriter methods to write attributes on element nodes. Questi metodi possono essere usati anche per creare dichiarazioni dello spazio dei nomi su un elemento, come illustrato nella sezione successiva.These methods can also be used to create namespace declarations on an element, as discussed in the next section.

UsaUse ATo
WriteAttributeString Per scrivere un intero nodo attributo, incluso un valore stringa.To write an entire attribute node, including a string value.
WriteStartAttribute Per scrivere il valore dell'attributo usando più chiamate al metodo.To write the attribute value using multiple method calls. Ad esempio, è possibile chiamare WriteValue per scrivere un valore tipizzato.For example, you can call WriteValue to write a typed value. Si tratta di una versione più sofisticata del metodo WriteElementString.This is a more sophisticated version of the WriteElementString method.

Per chiudere l'elemento, chiamare il metodo WriteEndAttribute.To close the element, you call the WriteEndAttribute method.
WriteAttributes Per copiare tutti gli attributi rilevati nella posizione corrente di un oggetto XmlReader.To copy all the attributes found at the current position of an XmlReader object. Gli attributi scritti dipendono dal tipo di nodo su cui è attualmente posizionato il lettore:The attributes that are written depend on the type of node the reader is currently positioned on:

-Per un nodo attributo, scrive l'attributo corrente e quindi il resto degli attributi fino al tag di chiusura dell'elemento.- For an attribute node, it writes the current attribute, and then the rest of the attributes until the element closing tag.
-Per un nodo elemento, vengono scritti tutti gli attributi contenuti nell'elemento.- For an element node, it writes all attributes contained by the element.
-Per un nodo di dichiarazione XML, scrive tutti gli attributi nella dichiarazione.- For an XML declaration node, it writes all the attributes in the declaration.
-Per tutti gli altri tipi di nodo, il metodo genera un'eccezione.- For all other node types, the method throws an exception.

Gestione degli spazi dei nomiHandling namespaces

Gli spazi dei nomi consentono di qualificare i nomi di elementi e attributi in un documento XML.Namespaces are used to qualify element and attribute names in an XML document. I prefissi degli spazi dei nomi associano elementi e attributi agli spazi dei nomi, che a loro volta sono associati a riferimenti URI.Namespace prefixes associate elements and attributes with namespaces, which are in turn associated with URI references. Gli spazi dei nomi assicurano l'univocità dei nomi di elementi e attributi in un documento XML.Namespaces create element and attribute name uniqueness in an XML document.

Il XmlWriter gestisce uno stack dello spazio dei nomi che corrisponde a tutti gli spazi dei nomi definiti nell'ambito dello spazio dei nomi corrente.The XmlWriter maintains a namespace stack that corresponds to all the namespaces defined in the current namespace scope. Quando si scrivono elementi e attributi, è possibile utilizzare gli spazi dei nomi nei seguenti modi:When writing elements and attributes you can utilize namespaces in the following ways:

  • Dichiarare gli spazi dei nomi manualmente usando il metodo WriteAttributeString.Declare namespaces manually by using the WriteAttributeString method. Può essere utile quando si conosce il metodo migliore per ottimizzare il numero di dichiarazioni dello spazio dei nomi.This can be useful when you know how to best optimize the number of namespace declarations. Per un esempio, vedere il metodo WriteAttributeString(String, String, String, String).For an example, see the WriteAttributeString(String, String, String, String) method.

  • Sostituire la dichiarazione dello spazio dei nomi corrente con un nuovo spazio dei nomi.Override the current namespace declaration with a new namespace. Nel codice seguente il metodo WriteAttributeString modifica l'URI dello spazio dei nomi per il prefisso "x" da "123" a "abc".In the following code, the WriteAttributeString method changes the namespace URI for the "x" prefix from "123" to "abc".

    writer.WriteStartElement("x", "root", "123");
    writer.WriteStartElement("item");
    writer.WriteAttributeString("xmlns", "x", null, "abc");
    writer.WriteEndElement();
    writer.WriteEndElement();
    
    writer.WriteStartElement("x", "root", "123")
    writer.WriteStartElement("item")
    writer.WriteAttributeString("xmlns", "x", Nothing, "abc")
    writer.WriteEndElement()
    writer.WriteEndElement()
    

    Tale codice genererà la stringa XML seguente:The code generates the following XML string:

    <x:root xmlns:x="123">  
      <item xmlns:x="abc" />  
    </x:root>  
    
  • Specificare un prefisso dello spazio dei nomi quando si scrivono attributi o elementi.Specify a namespace prefix when writing attributes or elements. Molti dei metodi usati per scrivere elementi e attributi consentono di eseguire questa operazione.Many of the methods used to write element and attributes enable you to do this. Il metodo WriteStartElement(String, String, String), ad esempio, scrive un tag di inizio e lo associa allo spazio dei nomi e al prefisso specificati.For example, the WriteStartElement(String, String, String) method writes a start tag and associates it with a specified namespace and prefix.

Scrittura di dati tipizzatiWriting typed data

Il metodo WriteValue accetta un oggetto Common Language Runtime (CLR), converte il valore di input nella relativa rappresentazione di stringa in base alle regole di conversione del tipo di dati XML Schema Definition Language (XSD) e lo scrive usando il metodo WriteString.The WriteValue method accepts a common language runtime (CLR) object, converts the input value to its string representation according to XML schema definition language (XSD) data type conversion rules, and writes it out by using the WriteString method. Questa operazione è più semplice rispetto all'uso dei metodi nella classe XmlConvert per convertire i dati tipizzati in un valore stringa prima di scriverli.This is easier than using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Quando si scrive nel testo, il valore tipizzato viene serializzato in testo utilizzando le regole XmlConvert per quel tipo di schema.When writing to text, the typed value is serialized to text by using the XmlConvert rules for that schema type.

Per i tipi di dati XSD predefiniti che corrispondono ai tipi CLR, vedere il metodo WriteValue.For default XSD data types that correspond to CLR types, see the WriteValue method.

Il XmlWriter può essere utilizzato anche per scrivere in un archivio dati XML.The XmlWriter can also be used to write to an XML data store. Ad esempio, la classe XPathNavigator può creare un oggetto XmlWriter e quindi creare nodi per un oggetto XmlDocument.For example, the XPathNavigator class can create an XmlWriter object to create nodes for an XmlDocument object. Se all'archivio dati sono disponibili informazioni sullo schema, il metodo WriteValue genera un'eccezione se si tenta di eseguire la conversione in un tipo non consentito. Se all'archivio dati non sono disponibili informazioni sullo schema, il metodo WriteValue considera tutti i valori come un tipo di xsd:anySimpleType.If the data store has schema information available to it, the WriteValue method throws an exception if you try to convert to a type that is not allowed.If the data store does not have schema information available to it, the WriteValue method treats all values as an xsd:anySimpleType type.

Chiusura del writer XMLClosing the XML writer

Quando si usano XmlWriter metodi per l'output di codice XML, gli elementi e gli attributi non vengono scritti fino a quando non si chiama il metodo di Close.When you use XmlWriter methods to output XML, the elements and attributes are not written until you call the Close method. Se ad esempio si usa XmlWriter per popolare un oggetto XmlDocument, non sarà possibile visualizzare gli elementi e gli attributi scritti nel documento di destinazione fino a quando non si chiude l'istanza di XmlWriter.For example, if you are using XmlWriter to populate an XmlDocument object, you won't be able to see the written elements and attributes in the target document until you close the XmlWriter instance.

Programmazione asincronaAsynchronous programming

Nella maggior parte dei XmlWriter metodi sono presenti controparti asincrone con "Async" alla fine dei rispettivi nomi di metodo.Most of the XmlWriter methods have asynchronous counterparts that have "Async" at the end of their method names. Ad esempio, l'equivalente asincrono di WriteAttributeString è WriteAttributeStringAsync.For example, the asynchronous equivalent of WriteAttributeString is WriteAttributeStringAsync.

Per il metodo WriteValue, che non ha una controparte asincrona, convertire il valore restituito in una stringa e usare invece il metodo WriteStringAsync.For the WriteValue method, which doesn't have an asynchronous counterpart, convert the return value to a string and use the WriteStringAsync method instead.

Considerazioni sulla sicurezzaSecurity considerations

Quando si utilizza la classe XmlWriter, tenere presente quanto segue:Consider the following when working with the XmlWriter class:

  • Le eccezioni generate dal XmlWriter possono rivelare le informazioni sul percorso che non si desidera vengano propagate all'app.Exceptions thrown by the XmlWriter can disclose path information that you do not want bubbled up to the app. L'app deve intercettare le eccezioni ed elaborarle in modo appropriato.Your app must catch exceptions and process them appropriately.

  • XmlWriter non convalida i dati passati al metodo WriteDocType o WriteRaw.XmlWriter does not validate any data that is passed to the WriteDocType or WriteRaw method. Non passare dati arbitrari a questi metodi.You should not pass arbitrary data to these methods.

Costruttori

XmlWriter()

Inizializza una nuova istanza della classe XmlWriter.Initializes a new instance of the XmlWriter class.

Proprietà

Settings

Ottiene l'oggetto XmlWriterSettings usato per creare questa istanza di XmlWriter.Gets the XmlWriterSettings object used to create this XmlWriter instance.

WriteState

Quando ne viene eseguito l'override in una classe derivata, ottiene lo stato del writer.When overridden in a derived class, gets the state of the writer.

XmlLang

Quando ne viene eseguito l'override in una classe derivata, ottiene l'ambito xml:lang corrente.When overridden in a derived class, gets the current xml:lang scope.

XmlSpace

Quando sottoposto a override in una classe derivata, ottiene un'enumerazione XmlSpace che rappresenta l'ambito xml:space corrente.When overridden in a derived class, gets an XmlSpace representing the current xml:space scope.

Metodi

Close()

Quando ne viene eseguito l'override in una classe derivata, chiude questo flusso e quello sottostante.When overridden in a derived class, closes this stream and the underlying stream.

Create(Stream)

Crea una nuova istanza di XmlWriter utilizzando il flusso specificato.Creates a new XmlWriter instance using the specified stream.

Create(Stream, XmlWriterSettings)

Crea una nuova istanza della classe XmlWriter utilizzando il flusso e l'oggetto XmlWriterSettings.Creates a new XmlWriter instance using the stream and XmlWriterSettings object.

Create(String)

Crea una nuova istanza della classe XmlWriter utilizzando il nome file specificato.Creates a new XmlWriter instance using the specified filename.

Create(String, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando il nome file e l'oggetto XmlWriterSettings.Creates a new XmlWriter instance using the filename and XmlWriterSettings object.

Create(StringBuilder)

Crea una nuova istanza di XmlWriter utilizzando l'oggetto StringBuilder specificato.Creates a new XmlWriter instance using the specified StringBuilder.

Create(StringBuilder, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti StringBuilder e XmlWriterSettings.Creates a new XmlWriter instance using the StringBuilder and XmlWriterSettings objects.

Create(TextWriter)

Crea una nuova istanza di XmlWriter utilizzando l'oggetto TextWriter specificato.Creates a new XmlWriter instance using the specified TextWriter.

Create(TextWriter, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti TextWriter e XmlWriterSettings.Creates a new XmlWriter instance using the TextWriter and XmlWriterSettings objects.

Create(XmlWriter)

Crea una nuova istanza della classe XmlWriter utilizzando l'oggetto XmlWriter specificato.Creates a new XmlWriter instance using the specified XmlWriter object.

Create(XmlWriter, XmlWriterSettings)

Crea una nuova istanza di XmlWriter utilizzando gli oggetti XmlWriter e XmlWriterSettings specificati.Creates a new XmlWriter instance using the specified XmlWriter and XmlWriterSettings objects.

Dispose()

Rilascia tutte le risorse usate dall'istanza corrente della classe XmlWriter.Releases all resources used by the current instance of the XmlWriter class.

Dispose(Boolean)

Rilascia le risorse non gestite usate da XmlWriter e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the XmlWriter and optionally releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Flush()

Quando ne viene eseguito l'override in una classe derivata, scarica il contenuto del buffer nei flussi sottostanti e scarica anche il flusso sottostante.When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

FlushAsync()

Scarica in modo asincrono il contenuto del buffer nei flussi sottostanti e scarica anche il flusso sottostante.Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
LookupPrefix(String)

Quando ne viene eseguito l'override in una classe derivata, restituisce il prefisso più vicino definito nell'ambito dello spazio dei nomi corrente per l'URI dello spazio dei nomi.When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
WriteAttributes(XmlReader, Boolean)

Quando sottoposto a override in una classe derivata, scrive tutti gli attributi individuati in corrispondenza della posizione corrente nell'oggetto XmlReader.When overridden in a derived class, writes out all the attributes found at the current position in the XmlReader.

WriteAttributesAsync(XmlReader, Boolean)

In modo asincrono scrive tutti gli attributi individuati in corrispondenza della posizione corrente nell'oggetto XmlReader.Asynchronously writes out all the attributes found at the current position in the XmlReader.

WriteAttributeString(String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive l'attributo con il nome locale e il valore specificati.When overridden in a derived class, writes out the attribute with the specified local name and value.

WriteAttributeString(String, String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive un attributo con il nome locale, l'URI dello spazio dei nomi e il valore specificati.When overridden in a derived class, writes an attribute with the specified local name, namespace URI, and value.

WriteAttributeString(String, String, String, String)

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.When overridden in a derived class, writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteAttributeStringAsync(String, String, String, String)

Scrive in modo asincrono un attributo con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.

WriteBase64(Byte[], Int32, Int32)

Quando ne viene eseguito l'override in una classe derivata, codifica i byte binari specificati come valori Base64 e scrive il testo risultante.When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32)

Codifica in modo asincrono i byte binari specificati come valori Base64 e scrive il testo risultante.Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.

WriteBinHex(Byte[], Int32, Int32)

Quando sottoposto a override in una classe derivata, codifica i byte binari specificati come valori BinHex e scrive il testo risultante.When overridden in a derived class, encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32)

Codifica in modo asincrono i byte binari specificati come valori BinHex e scrive il testo risultante.Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.

WriteCData(String)

Quando sottoposto a override in una classe derivata, scrive un blocco <![CDATA[...]]> che contiene il testo specificato.When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String)

Scrive in modo asincrono un blocco <![CDATA[...]]> che contiene il testo specificato.Asynchronously writes out a <![CDATA[...]]> block containing the specified text.

WriteCharEntity(Char)

Quando ne viene eseguito l'override in una classe derivata, forza la generazione di un'entità carattere per il valore del carattere Unicode specificato.When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value.

WriteCharEntityAsync(Char)

Forza in modo asincrono la generazione di un'entità carattere per il valore del carattere Unicode specificato.Asynchronously forces the generation of a character entity for the specified Unicode character value.

WriteChars(Char[], Int32, Int32)

Quando ne viene eseguito l'override in una classe derivata, scrive il testo in un buffer alla volta.When overridden in a derived class, writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32)

Scrive in modo asincrono il testo in un buffer alla volta.Asynchronously writes text one buffer at a time.

WriteComment(String)

Quando sottoposto a override in una classe derivata, scrive un commento <!--...--> che contiene il testo specificato.When overridden in a derived class, writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String)

Scrive in modo asincrono un commento <!--...--> che contiene il testo specificato.Asynchronously writes out a comment <!--...--> containing the specified text.

WriteDocType(String, String, String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione DOCTYPE con il nome e gli attributi facoltativi specificati.When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String)

Scrive in modo asincrono la dichiarazione DOCTYPE con il nome e gli attributi facoltativi specificati.Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.

WriteElementString(String, String)

Scrive un elemento con il nome locale e il valore specificati.Writes an element with the specified local name and value.

WriteElementString(String, String, String)

Scrive un elemento con il nome locale, l'URI dello spazio dei nomi e il valore specificati.Writes an element with the specified local name, namespace URI, and value.

WriteElementString(String, String, String, String)

Scrive un elemento con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.Writes an element with the specified prefix, local name, namespace URI, and value.

WriteElementStringAsync(String, String, String, String)

Scrive in modo asincrono un elemento con il prefisso, il nome locale, l'URI dello spazio dei nomi e il valore specificati.Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.

WriteEndAttribute()

Quando se ne esegue l'override in una classe derivata, chiude la precedente chiamata al metodo WriteStartAttribute(String, String).When overridden in a derived class, closes the previous WriteStartAttribute(String, String) call.

WriteEndAttributeAsync()

Chiude in modo asincrono la chiamata WriteStartAttribute(String, String) precedente.Asynchronously closes the previous WriteStartAttribute(String, String) call.

WriteEndDocument()

Quando se ne esegue l'override in una classe derivata, chiude qualsiasi elemento o attributo aperto e riporta il writer allo stato di avvio.When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state.

WriteEndDocumentAsync()

Chiude in modo asincrono qualsiasi elemento o attributo aperto e riporta il writer allo stato di avvio.Asynchronously closes any open elements or attributes and puts the writer back in the Start state.

WriteEndElement()

Quando ne viene eseguito l'override in una classe derivata, chiude un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteEndElementAsync()

Chiude in modo asincrono un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.Asynchronously closes one element and pops the corresponding namespace scope.

WriteEntityRef(String)

Se sottoposto a override in una classe derivata, scrive un riferimento a entità con formato &name;.When overridden in a derived class, writes out an entity reference as &name;.

WriteEntityRefAsync(String)

In modo asincrono scrive un riferimento all'entità come &name;.Asynchronously writes out an entity reference as &name;.

WriteFullEndElement()

Quando ne viene eseguito l'override in una classe derivata, chiude un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.When overridden in a derived class, closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync()

Chiude in modo asincrono un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.Asynchronously closes one element and pops the corresponding namespace scope.

WriteName(String)

Quando sottoposto a override in una classe derivata, inserisce il nome specificato, verificando che si tratti di un nome valido in base alla raccomandazione W3C XML 1.0, disponibile all'indirizzo https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNameAsync(String)

Inserisce in modo asincrono il nome specificato, verificando che si tratti di un nome valido in base alla raccomandazione W3C XML 1.0, disponibile all'indirizzo https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmToken(String)

Quando sottoposto a override in una classe derivata, inserisce il nome specificato, verificando che si tratti di un NmToken valido in base alla raccomandazione W3C XML 1.0, disponibile all'indirizzo https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNmTokenAsync(String)

Inserisce in modo asincrono il nome specificato, verificando che si tratti di un NmToken valido in base alla raccomandazione W3C XML 1.0, disponibile all'indirizzo https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

WriteNode(XmlReader, Boolean)

Quando ne viene eseguito l'override in una classe derivata, copia tutto il contenuto del lettore nel writer e sposta il lettore all'inizio del successivo elemento di pari livello.When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNode(XPathNavigator, Boolean)

Copia tutti gli elementi dall'oggetto XPathNavigator nel writer.Copies everything from the XPathNavigator object to the writer. La posizione di XPathNavigator resta invariata.The position of the XPathNavigator remains unchanged.

WriteNodeAsync(XmlReader, Boolean)

Copia in modo asincrono tutto il contenuto del lettore nel writer e sposta il lettore sul successivo elemento di pari livello.Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.

WriteNodeAsync(XPathNavigator, Boolean)

Copia in modo asincrono tutti gli elementi dall'oggetto XPathNavigator al writer.Asynchronously copies everything from the XPathNavigator object to the writer. La posizione di XPathNavigator resta invariata.The position of the XPathNavigator remains unchanged.

WriteProcessingInstruction(String, String)

Quando sottoposto a override in una classe derivata, scrive un'istruzione di elaborazione con uno spazio tra il nome e il testo, come segue: <?name text?>.When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteProcessingInstructionAsync(String, String)

Scrive in modo asincrono un'istruzione di elaborazione con uno spazio tra il nome e il testo, come segue: <?name text?>.Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>.

WriteQualifiedName(String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive il nome completo dello spazio dei nomi.When overridden in a derived class, writes out the namespace-qualified name. Questo metodo esegue la ricerca del prefisso incluso nell'ambito dello spazio dei nomi specificato.This method looks up the prefix that is in scope for the given namespace.

WriteQualifiedNameAsync(String, String)

Scrive in modo asincrono il nome completo dello spazio dei nomi.Asynchronously writes out the namespace-qualified name. Questo metodo esegue la ricerca del prefisso incluso nell'ambito dello spazio dei nomi specificato.This method looks up the prefix that is in scope for the given namespace.

WriteRaw(Char[], Int32, Int32)

Quando ne viene eseguito l'override in una classe derivata, scrive manualmente markup non elaborato in base a un buffer di caratteri.When overridden in a derived class, writes raw markup manually from a character buffer.

WriteRaw(String)

Quando ne viene eseguito l'override in una classe derivata, scrive manualmente markup non elaborato in base a una stringa.When overridden in a derived class, writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32)

Scrive manualmente in modo asincrono markup non elaborato in base a un buffer di caratteri.Asynchronously writes raw markup manually from a character buffer.

WriteRawAsync(String)

Scrive manualmente in modo asincrono markup non elaborato in base a una stringa.Asynchronously writes raw markup manually from a string.

WriteStartAttribute(String)

Scrive l'inizio di un attributo con il nome locale specificato.Writes the start of an attribute with the specified local name.

WriteStartAttribute(String, String)

Scrive l'inizio di un attributo con il nome locale e l'URI dello spazio dei nomi specificati.Writes the start of an attribute with the specified local name and namespace URI.

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.When overridden in a derived class, writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartAttributeAsync(String, String, String)

Scrive in modo asincrono l'inizio di un attributo con il prefisso, il nome locale e l'URI dello spazio dei nomi specificati.Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.

WriteStartDocument()

Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0".When overridden in a derived class, writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean)

Quando ne viene eseguito l'override in una classe derivata, scrive la dichiarazione XML in base alla versione "1.0" e all'attributo standalone.When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync()

Scrive in modo asincrono la dichiarazione XML con la versione "1.0".Asynchronously writes the XML declaration with the version "1.0".

WriteStartDocumentAsync(Boolean)

Scrive in modo asincrono la dichiarazione XML con la versione "1.0" e l'attributo standalone.Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartElement(String)

Quando ne viene eseguito l'override in una classe derivata, scrive un tag di inizio con il nome locale specificato.When overridden in a derived class, writes out a start tag with the specified local name.

WriteStartElement(String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive il tag di inizio specificato e lo associa allo spazio dei nomi indicato.When overridden in a derived class, writes the specified start tag and associates it with the given namespace.

WriteStartElement(String, String, String)

Quando ne viene eseguito l'override in una classe derivata, scrive il tag di inizio specificato e lo associa allo spazio dei nomi e al prefisso specificati.When overridden in a derived class, writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String)

Scrive in modo asincrono il tag di inizio specificato e lo associa allo spazio dei nomi e al prefisso specificati.Asynchronously writes the specified start tag and associates it with the given namespace and prefix.

WriteString(String)

Quando ne viene eseguito l'override in una classe derivata, scrive il contenuto di testo specificato.When overridden in a derived class, writes the given text content.

WriteStringAsync(String)

Scrive in modo asincrono il contenuto di testo specificato.Asynchronously writes the given text content.

WriteSurrogateCharEntity(Char, Char)

Quando ne viene eseguito l'override in una classe derivata, genera e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

WriteSurrogateCharEntityAsync(Char, Char)

Genera in modo asincrono e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.Asynchronously generates and writes the surrogate character entity for the surrogate character pair.

WriteValue(Boolean)

Scrive un valore Boolean.Writes a Boolean value.

WriteValue(DateTime)

Scrive un valore DateTime.Writes a DateTime value.

WriteValue(DateTimeOffset)

Scrive un valore DateTimeOffset.Writes a DateTimeOffset value.

WriteValue(Decimal)

Scrive un valore Decimal.Writes a Decimal value.

WriteValue(Double)

Scrive un valore Double.Writes a Double value.

WriteValue(Int32)

Scrive un valore Int32.Writes a Int32 value.

WriteValue(Int64)

Scrive un valore Int64.Writes a Int64 value.

WriteValue(Object)

Scrive il valore dell'oggetto.Writes the object value.

WriteValue(Single)

Scrive un numero a virgola mobile e precisione singola.Writes a single-precision floating-point number.

WriteValue(String)

Scrive un valore String.Writes a String value.

WriteWhitespace(String)

Quando ne viene eseguito l'override in una classe derivata, scrive lo spazio specificato.When overridden in a derived class, writes out the given white space.

WriteWhitespaceAsync(String)

Scrive in modo asincrono lo spazio vuoto specificato.Asynchronously writes out the given white space.

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose()

Per una descrizione di questo membro, vedere Dispose().For a description of this member, see Dispose().

Si applica a

Vedi anche