XmlTextWriter XmlTextWriter XmlTextWriter XmlTextWriter Class

Definizione

Rappresenta un writer che fornisce un modo veloce, non in cache e di tipo forward-only di generare flussi o file che contengono dati XML conformi alle raccomandazioni W3C Extensible Markup Language (XML) 1.0 e Namespaces in XML.Represents a writer that provides a fast, non-cached, forward-only way of generating streams or files containing XML data that conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations.

A partire da .NET Framework 2.0, è consigliabile usare la classe XmlWriter.Starting with the .NET Framework 2.0, we recommend that you use the XmlWriter class instead.

public ref class XmlTextWriter : System::Xml::XmlWriter
public class XmlTextWriter : System.Xml.XmlWriter
type XmlTextWriter = class
    inherit XmlWriter
Public Class XmlTextWriter
Inherits XmlWriter
Ereditarietà
XmlTextWriterXmlTextWriterXmlTextWriterXmlTextWriter

Commenti

Questa classe implementa la XmlWriter classe.This class implements the XmlWriter class.

Nota

A partire da .NET Framework 2,0, è consigliabile creare XmlWriter istanze usando il XmlWriter.Create metodo e la XmlWriterSettings classe per sfruttare le nuove funzionalità.Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

XmlTextWritermantiene uno stack dello spazio dei nomi corrispondente a tutti gli spazi dei nomi definiti nello stack di elementi corrente.XmlTextWriter maintains a namespace stack corresponding to all the namespaces defined in the current element stack. Utilizzando XmlTextWriter è possibile dichiarare manualmente gli spazi dei nomi.Using XmlTextWriter you can declare namespaces manually.

w.WriteStartElement("root");  
w.WriteAttributeString("xmlns", "x", null, "urn:1");  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
 w.WriteStartElement("item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  

Il codice C# precedente produce l'output seguente.The above C# code produces the following output. XmlTextWriterpromuove la dichiarazione dello spazio dei nomi all'elemento radice per evitare che venga duplicato nei due elementi figlio.XmlTextWriter promotes the namespace declaration to the root element to avoid having it duplicated on the two child elements. Gli elementi figlio prelevano il prefisso dalla dichiarazione dello spazio dei nomi.The child elements pick up the prefix from the namespace declaration.

<root xmlns:x="urn:1">  
 <x:item/>  
 <x:item/>  
</x:root>  

XmlTextWriterconsente inoltre di eseguire l'override della dichiarazione dello spazio dei nomi corrente.XmlTextWriter also allows you to override the current namespace declaration. Nell'esempio seguente, l'URI dello spazio dei nomi "123" viene sottoposto a override da "ABC" per <x:node xmlns:x="abc"/>produrre l'elemento XML.In the following example, the namespace URI "123" is overridden by "abc" to produce the XML element <x:node xmlns:x="abc"/>.

w.WriteStartElement("x","node","123");  
w.WriteAttributeString("xmlns","x",null,"abc");  

Usando i metodi Write che accettano un prefisso come argomento, è anche possibile specificare il prefisso da usare.By using the write methods that take a prefix as an argument you can also specify which prefix to use. Nell'esempio seguente viene eseguito il mapping di due prefissi diversi allo stesso URI dello spazio dei nomi per produrre <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>il testo XML.In the following example, two different prefixes are mapped to the same namespace URI to produce the XML text <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.WriteStartElement("x","root","urn:1");  
 w.WriteStartElement("y","item","urn:1");  
 w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

Se sono presenti più dichiarazioni dello spazio dei nomi che eseguono il mapping di prefissi diversi XmlTextWriter allo stesso URI dello spazio dei nomi, scorre lo stack delle dichiarazioni dello spazio dei nomi all'indietro e sceglie quello più vicino.If there are multiple namespace declarations mapping different prefixes to the same namespace URI, XmlTextWriter walks the stack of namespace declarations backwards and picks the closest one.

XmlTextWriter w = new XmlTextWriter(Console.Out);  
w.Formatting = Formatting.Indented;  
w.WriteStartElement("x","root","urn:1");  
w.WriteStartElement("y","item","urn:1");  
w.WriteAttributeString("attr","urn:1","123");  
w.WriteEndElement();  
w.WriteEndElement();  
w.Close();  

Nell'esempio precedente C# , poiché la WriteAttributeString chiamata non specifica un prefisso, il writer usa l'ultimo prefisso inserito nello stack dello spazio dei nomi e produce il codice XML seguente:In the above C# example, because the WriteAttributeString call does not specify a prefix, the writer uses the last prefix pushed onto the namespace stack, and produces the following XML:

<x:root xmlns:x="urn:1">  
 <y:item y:attr="123" xmlns:y="urn:1" />  
</x:root>  

Se si verificano conflitti XmlTextWriter tra gli spazi dei nomi, li risolve generando prefissi alternativi.If namespace conflicts occur, XmlTextWriter resolves them by generating alternate prefixes. Se, ad esempio, un attributo e un elemento hanno lo stesso prefisso ma spazi dei XmlWriter nomi diversi, genera un prefisso alternativo per l'attributo.For example, if an attribute and element have the same prefix but different namespaces, XmlWriter generates an alternate prefix for the attribute. I prefissi generati vengono denominati n{i} dove è un numero che i inizia con 1.The generated prefixes are named n{i} where i is a number beginning at 1. Il numero viene reimpostato su 1 per ogni elemento.The number is reset to 1 for each element.

Gli attributi associati a un URI dello spazio dei nomi devono avere un prefisso (gli spazi dei nomi predefiniti non si applicano agli attributi).Attributes which are associated with a namespace URI must have a prefix (default namespaces do not apply to attributes). Questo è conforme alla sezione 5,2 della raccomandazione W3C Namespaces in XML.This conforms to section 5.2 of the W3C Namespaces in XML recommendation. Se un attributo fa riferimento a un URI dello spazio dei nomi, ma non specifica un prefisso, il writer genera un prefisso per l'attributo.If an attribute references a namespace URI, but does not specify a prefix, the writer generates a prefix for the attribute.

Quando si scrive un elemento vuoto, ad esempio <item />, viene aggiunto uno spazio aggiuntivo tra il nome del tag e il tag di chiusura.When writing an empty element, an additional space is added between tag name and the closing tag, for example <item />. Ciò garantisce la compatibilità con i browser meno recenti.This provides compatibility with older browsers.

Quando un String oggetto viene utilizzato come parametro del null metodo String.Empty , e sono equivalenti.When a String is used as method parameter, null and String.Empty are equivalent. String.Emptysegue le regole W3C.String.Empty follows the W3C rules.

Per scrivere dati fortemente tipizzati, usare XmlConvert la classe per convertire i tipi di dati in stringa.To write strongly typed data, use the XmlConvert class to convert data types to string. C# Il codice seguente, ad esempio, converte i dati Double da String a e scrive l' <price>19.95</price>elemento.For example, the following C# code converts the data from Double to String and writes the element <price>19.95</price>.

Double price = 19.95;  
writer.WriteElementString("price", XmlConvert.ToString(price));  

XmlTextWriternon verifica la presenza di quanto segue:XmlTextWriter does not check for the following:

  • Caratteri non validi nei nomi degli attributi e degli elementi.Invalid characters in attribute and element names.

  • Caratteri Unicode che non rientrano nella codifica specificata.Unicode characters that do not fit the specified encoding. Se i caratteri Unicode non corrispondono alla codifica specificata, XmlTextWriter non esegue l'escape dei caratteri Unicode in entità carattere.If the Unicode characters do not fit the specified encoding, the XmlTextWriter does not escape the Unicode characters into character entities.

  • Attributi duplicati.Duplicate attributes.

  • Caratteri nell'identificatore pubblico DOCTYPE o nell'identificatore di sistema.Characters in the DOCTYPE public identifier or system identifier.

Considerazioni sulla sicurezzaSecurity Considerations

Gli elementi seguenti sono aspetti da considerare quando si utilizza la XmlTextWriter classe.The following items are things to consider when working with the XmlTextWriter class.

  • Le XmlTextWriter eccezioni generate da possono rivelare informazioni sui percorsi che non si desidera vengano propagate all'applicazione.Exceptions thrown by the XmlTextWriter can disclose path information that you do not want bubbled up to the application. Le applicazioni devono intercettare le eccezioni ed elaborarle in modo adeguato.Your applications must catch exceptions and process them appropriately.

  • Quando si passa il tipo XmlTextWriter a un'altra applicazione, il flusso sottostante è esposto all'applicazione.When you pass the XmlTextWriter to another application the underlying stream is exposed to that application. Se si deve passare l'oggetto XmlTextWriter a un'applicazione con attendibilità parziale, è invece necessario utilizzare un oggetto XmlWriter creato dal metodo Create.If you need to pass the XmlTextWriter to a semi-trusted application, you should use an XmlWriter object created by the Create method instead.

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

  • Se le impostazioni predefinite vengono modificate, non vi è alcuna garanzia che l'output generato sia costituito da dati XML ben formati.If the default settings are changed, there is no guarantee that the generated output is well-formed XML data.

  • Non accettare componenti di supporto, ad esempio un Encoding oggetto, da un'origine non attendibile.Do not accept supporting components, such as an Encoding object, from an untrusted source.

Costruttori

XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding) XmlTextWriter(Stream, Encoding)

Crea un'istanza della classe XmlTextWriter utilizzando la codifica e il flusso specificati.Creates an instance of the XmlTextWriter class using the specified stream and encoding.

XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding) XmlTextWriter(String, Encoding)

Crea un'istanza della classe XmlTextWriter utilizzando il file specificato.Creates an instance of the XmlTextWriter class using the specified file.

XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter) XmlTextWriter(TextWriter)

Crea un'istanza della classe XmlTextWriter utilizzando l'oggetto TextWriter specificato.Creates an instance of the XmlTextWriter class using the specified TextWriter.

Proprietà

BaseStream BaseStream BaseStream BaseStream

Ottiene l'oggetto flusso sottostante.Gets the underlying stream object.

Formatting Formatting Formatting Formatting

Indica come viene formattato l'output.Indicates how the output is formatted.

Indentation Indentation Indentation Indentation

Ottiene o imposta il numero di oggetti IndentChars da scrivere per ciascun livello nella gerarchia quando la proprietà Formatting è impostata su Formatting.Indented.Gets or sets how many IndentChars to write for each level in the hierarchy when Formatting is set to Formatting.Indented.

IndentChar IndentChar IndentChar IndentChar

Ottiene o imposta il carattere da utilizzare per il rientro quando la proprietà Formatting è impostata su Formatting.Indented.Gets or sets which character to use for indenting when Formatting is set to Formatting.Indented.

Namespaces Namespaces Namespaces Namespaces

Ottiene o imposta un valore che indica se supportare gli spazi dei nomi.Gets or sets a value indicating whether to do namespace support.

QuoteChar QuoteChar QuoteChar QuoteChar

Ottiene o imposta il carattere da usare per racchiudere tra virgolette i valori degli attributi.Gets or sets which character to use to quote attribute values.

Settings Settings Settings Settings

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

(Inherited from XmlWriter)
WriteState WriteState WriteState WriteState

Ottiene lo stato del writer.Gets the state of the writer.

XmlLang XmlLang XmlLang XmlLang

Ottiene l'ambito xml:lang corrente.Gets the current xml:lang scope.

XmlSpace XmlSpace XmlSpace XmlSpace

Ottiene un oggetto XmlSpace che rappresenta l'ambito xml:space corrente.Gets an XmlSpace representing the current xml:space scope.

Metodi

Close() Close() Close() Close()

Chiude questo flusso e quello sottostante.Closes this stream and the underlying stream.

Dispose() Dispose() Dispose() Dispose()

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

(Inherited from XmlWriter)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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.

(Inherited from XmlWriter)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Flush() Flush() Flush() Flush()

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

FlushAsync() FlushAsync() FlushAsync() 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.

(Inherited from XmlWriter)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
LookupPrefix(String) LookupPrefix(String) LookupPrefix(String) LookupPrefix(String)

Restituisce il prefisso più vicino definito nell'ambito dello spazio dei nomi corrente per l'URI dello spazio dei nomi.Returns the closest prefix defined in the current namespace scope for the namespace URI.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) WriteAttributes(XmlReader, Boolean) 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.

(Inherited from XmlWriter)
WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) WriteAttributesAsync(XmlReader, Boolean) 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.

(Inherited from XmlWriter)
WriteAttributeString(String, String) WriteAttributeString(String, String) WriteAttributeString(String, String) 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.

(Inherited from XmlWriter)
WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) WriteAttributeString(String, String, String) 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.

(Inherited from XmlWriter)
WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) WriteAttributeString(String, String, String, String) 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.

(Inherited from XmlWriter)
WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) WriteAttributeStringAsync(String, String, String, String) 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.

(Inherited from XmlWriter)
WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32) WriteBase64(Byte[], Int32, Int32)

Codifica i byte binari specificati come valori Base64 e scrive il testo risultante.Encodes the specified binary bytes as base64 and writes out the resulting text.

WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) WriteBase64Async(Byte[], Int32, Int32) 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.

(Inherited from XmlWriter)
WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32) WriteBinHex(Byte[], Int32, Int32)

Codifica i byte binari specificati come valori BinHex e scrive il testo risultante.Encodes the specified binary bytes as binhex and writes out the resulting text.

WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) WriteBinHexAsync(Byte[], Int32, Int32) 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.

(Inherited from XmlWriter)
WriteCData(String) WriteCData(String) WriteCData(String) WriteCData(String)

Scrive un blocco <![CDATA[...]]> contenente il testo specificato.Writes out a <![CDATA[...]]> block containing the specified text.

WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String) WriteCDataAsync(String)

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

(Inherited from XmlWriter)
WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char) WriteCharEntity(Char)

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

WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) WriteCharEntityAsync(Char) 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.

(Inherited from XmlWriter)
WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32) WriteChars(Char[], Int32, Int32)

Il testo viene scritto in un buffer alla volta.Writes text one buffer at a time.

WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32) WriteCharsAsync(Char[], Int32, Int32)

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

(Inherited from XmlWriter)
WriteComment(String) WriteComment(String) WriteComment(String) WriteComment(String)

Scrive un commento <!--...--> contenente il testo specificato.Writes out a comment <!--...--> containing the specified text.

WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String) WriteCommentAsync(String)

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

(Inherited from XmlWriter)
WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String) WriteDocType(String, String, String, String)

Scrive la dichiarazione DOCTYPE con il nome e gli attributi opzionali specificati.Writes the DOCTYPE declaration with the specified name and optional attributes.

WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) WriteDocTypeAsync(String, String, String, String) 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.

(Inherited from XmlWriter)
WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String) WriteElementString(String, String)

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

(Inherited from XmlWriter)
WriteElementString(String, String, String) WriteElementString(String, String, String) WriteElementString(String, String, String) 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.

(Inherited from XmlWriter)
WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) WriteElementString(String, String, String, String) 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.

(Inherited from XmlWriter)
WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) WriteElementStringAsync(String, String, String, String) 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.

(Inherited from XmlWriter)
WriteEndAttribute() WriteEndAttribute() WriteEndAttribute() WriteEndAttribute()

Chiude la chiamata al metodo WriteStartAttribute(String, String, String) precedente.Closes the previous WriteStartAttribute(String, String, String) call.

WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync() WriteEndAttributeAsync()

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

(Inherited from XmlWriter)
WriteEndDocument() WriteEndDocument() WriteEndDocument() WriteEndDocument()

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

WriteEndDocumentAsync() WriteEndDocumentAsync() WriteEndDocumentAsync() 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.

(Inherited from XmlWriter)
WriteEndElement() WriteEndElement() WriteEndElement() WriteEndElement()

Chiude un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.Closes one element and pops the corresponding namespace scope.

WriteEndElementAsync() WriteEndElementAsync() WriteEndElementAsync() 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.

(Inherited from XmlWriter)
WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String) WriteEntityRef(String)

Scrive un riferimento a entità con formato &name;.Writes out an entity reference as &name;.

WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String) WriteEntityRefAsync(String)

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

(Inherited from XmlWriter)
WriteFullEndElement() WriteFullEndElement() WriteFullEndElement() WriteFullEndElement()

Chiude un elemento e visualizza l'ambito dello spazio dei nomi corrispondente.Closes one element and pops the corresponding namespace scope.

WriteFullEndElementAsync() WriteFullEndElementAsync() WriteFullEndElementAsync() 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.

(Inherited from XmlWriter)
WriteName(String) WriteName(String) WriteName(String) WriteName(String)

Inserisce il nome specificato, verificando che si tratti di un nome valido in base alla raccomandazione W3C XML 1.0.Writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation.

WriteNameAsync(String) WriteNameAsync(String) WriteNameAsync(String) 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).

(Inherited from XmlWriter)
WriteNmToken(String) WriteNmToken(String) WriteNmToken(String) WriteNmToken(String)

Inserisce il nome specificato, verificando che si tratti di un oggetto NmToken valido in base alla raccomandazione W3C XML 1.0.Writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation.

WriteNmTokenAsync(String) WriteNmTokenAsync(String) WriteNmTokenAsync(String) 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).

(Inherited from XmlWriter)
WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) WriteNode(XmlReader, Boolean) 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.

(Inherited from XmlWriter)
WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) WriteNode(XPathNavigator, Boolean) 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.

(Inherited from XmlWriter)
WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) WriteNodeAsync(XmlReader, Boolean) 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.

(Inherited from XmlWriter)
WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) WriteNodeAsync(XPathNavigator, Boolean) 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.

(Inherited from XmlWriter)
WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String) WriteProcessingInstruction(String, String)

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

WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) WriteProcessingInstructionAsync(String, String) 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?>.

(Inherited from XmlWriter)
WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String) WriteQualifiedName(String, String)

Scrive il nome completo dello spazio dei nomi.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) WriteQualifiedNameAsync(String, String) WriteQualifiedNameAsync(String, String) 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.

(Inherited from XmlWriter)
WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32) WriteRaw(Char[], Int32, Int32)

Scrive manualmente markup non elaborato in base a un buffer di caratteri.Writes raw markup manually from a character buffer.

WriteRaw(String) WriteRaw(String) WriteRaw(String) WriteRaw(String)

Scrive manualmente markup non elaborato in base a una stringa.Writes raw markup manually from a string.

WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) WriteRawAsync(Char[], Int32, Int32) 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.

(Inherited from XmlWriter)
WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String) WriteRawAsync(String)

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

(Inherited from XmlWriter)
WriteStartAttribute(String) WriteStartAttribute(String) WriteStartAttribute(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.

(Inherited from XmlWriter)
WriteStartAttribute(String, String) WriteStartAttribute(String, String) WriteStartAttribute(String, String) 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.

(Inherited from XmlWriter)
WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String) WriteStartAttribute(String, String, String)

Scrive l'inizio di un attributo.Writes the start of an attribute.

WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) WriteStartAttributeAsync(String, String, String) 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.

(Inherited from XmlWriter)
WriteStartDocument() WriteStartDocument() WriteStartDocument() WriteStartDocument()

Scrive la dichiarazione XML con la versione "1.0".Writes the XML declaration with the version "1.0".

WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean) WriteStartDocument(Boolean)

Scrive la dichiarazione XML con la versione "1.0" e l'attributo standalone.Writes the XML declaration with the version "1.0" and the standalone attribute.

WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync() WriteStartDocumentAsync()

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

(Inherited from XmlWriter)
WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) WriteStartDocumentAsync(Boolean) 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.

(Inherited from XmlWriter)
WriteStartElement(String) WriteStartElement(String) WriteStartElement(String) 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.

(Inherited from XmlWriter)
WriteStartElement(String, String) WriteStartElement(String, String) WriteStartElement(String, String) 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.

(Inherited from XmlWriter)
WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String) WriteStartElement(String, String, String)

Scrive il tag di inizio specificato e lo associa allo spazio dei nomi e al prefisso indicati.Writes the specified start tag and associates it with the given namespace and prefix.

WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) WriteStartElementAsync(String, String, String) 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.

(Inherited from XmlWriter)
WriteString(String) WriteString(String) WriteString(String) WriteString(String)

Scrive il contenuto di testo specificato.Writes the given text content.

WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String) WriteStringAsync(String)

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

(Inherited from XmlWriter)
WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char) WriteSurrogateCharEntity(Char, Char)

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

WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) WriteSurrogateCharEntityAsync(Char, Char) 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.

(Inherited from XmlWriter)
WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Scrive un valore Boolean.Writes a Boolean value.

(Inherited from XmlWriter)
WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Scrive un valore DateTime.Writes a DateTime value.

(Inherited from XmlWriter)
WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Scrive un valore DateTimeOffset.Writes a DateTimeOffset value.

(Inherited from XmlWriter)
WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Scrive un valore Decimal.Writes a Decimal value.

(Inherited from XmlWriter)
WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Scrive un valore Double.Writes a Double value.

(Inherited from XmlWriter)
WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Scrive un valore Int32.Writes a Int32 value.

(Inherited from XmlWriter)
WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Scrive un valore Int64.Writes a Int64 value.

(Inherited from XmlWriter)
WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

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

(Inherited from XmlWriter)
WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

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

(Inherited from XmlWriter)
WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Scrive un valore String.Writes a String value.

(Inherited from XmlWriter)
WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String) WriteWhitespace(String)

Scrive lo spazio vuoto specificato.Writes out the given white space.

WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String) WriteWhitespaceAsync(String)

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

(Inherited from XmlWriter)

Implementazioni dell'interfaccia esplicita

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

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

(Inherited from XmlWriter)

Si applica a

Vedi anche