XmlWriter.WriteValue Metodo

Definizione

Scrive un unico valore di tipo semplice.Writes a single simple-typed value.

Overload

WriteValue(String)

Scrive un valore String.Writes a String value.

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.

Commenti

Il WriteValue metodo accetta Common Language Runtime (CLR) valori con tipizzazione semplice, li converte nelle rappresentazioni di stringa in base alle regole di conversione del tipo di dati XML Schema Definition Language (XSD) e li scrive WriteString usando il Metodo.The WriteValue method accepts common language runtime (CLR) simple-typed values, converts them to their string representations according to the XML schema definition language (XSD) data type conversion rules, and writes them out by using the WriteString method. Ciò consente di eseguire la pipeline di valori di tipo semplice con sovraccarico di rianalisi minimo quando si XPathDocumentpassano XmlReaderdati tra XmlWriter oggetti, e.This enables you to pipeline simple-type values with minimal reparsing overhead when passing data between XPathDocument, XmlReader, and XmlWriter objects. Questa possibilità è utile anche quando si gestiscono i tipi semplici CLR e un' XmlWriter istanza.This ability is also useful when dealing with CLR simple-types and an XmlWriter instance. È possibile chiamare il WriteValue metodo per scrivere il valore tipizzato anziché usare i metodi XmlConvert della classe per convertire i dati tipizzati in un valore stringa prima di scriverli.You can call the WriteValue method to write the typed value instead of using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Per le operazioni asincrone, convertire il valore restituito WriteValue di in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of WriteValue to a string and use the WriteStringAsync method.

Nella tabella seguente sono illustrati i tipi di dati XSD predefiniti che corrispondono ai tipi CLR.The following table shows the default XSD data types that correspond to CLR types.

Se l'oggetto CLR è un tipo di elenco, ad esempio IEnumerable, IList o ICollection, verrà considerato una matrice del tipo di valore.If the CLR object is a list type, such as IEnumerable, IList, or ICollection, it is treated as an array of the value type.

Tipo CLRCLR type Tipo di dati XSD predefinitoDefault XSD data type
System.Boolean xsd:booleanxsd:boolean
System.Byte** xsd:integerxsd:integer
Matrice System.ByteSystem.Byte array xsd:base64Binaryxsd:base64Binary
System.Char** xsd:stringxsd:string
System.DateTime xsd:dateTimexsd:dateTime
System.Decimal xsd:decimalxsd:decimal
System.Double xsd:doublexsd:double
System.Int16** xsd:integerxsd:integer
System.Int32 xsd:integerxsd:integer
System.Int64 xsd:integerxsd:integer
System.Single xsd:floatxsd:float
System.String xsd:stringxsd:string
System.IO.TextReader xsd:stringxsd:string
System.IO.BinaryReader xsd:base64Binaryxsd:base64Binary

**Questi tipi non sono conformi a CLS.**These types are not CLS-compliant. Non dispongono di metodi corrispondenti WriteValue .They do not have corresponding WriteValue methods.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space.

WriteValue(String)

Scrive un valore String.Writes a String value.

public:
 virtual void WriteValue(System::String ^ value);
public virtual void WriteValue (string value);
abstract member WriteValue : string -> unit
override this.WriteValue : string -> unit
Public Overridable Sub WriteValue (value As String)

Parametri

value
String

Valore String da scrivere.The String value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, usare WriteStringAsync il metodo.For asynchronous operations, use the WriteStringAsync method.

WriteValue(Boolean)

Scrive un valore Boolean.Writes a Boolean value.

public:
 virtual void WriteValue(bool value);
public virtual void WriteValue (bool value);
abstract member WriteValue : bool -> unit
override this.WriteValue : bool -> unit
Public Overridable Sub WriteValue (value As Boolean)

Parametri

value
Boolean

Valore Boolean da scrivere.The Boolean value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(DateTime)

Scrive un valore DateTime.Writes a DateTime value.

public:
 virtual void WriteValue(DateTime value);
public virtual void WriteValue (DateTime value);
abstract member WriteValue : DateTime -> unit
override this.WriteValue : DateTime -> unit
Public Overridable Sub WriteValue (value As DateTime)

Parametri

value
DateTime

Valore DateTime da scrivere.The DateTime value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Esempi

Nell'esempio seguente viene scritto un nodo libro utilizzando dati tipizzati.The following example writes a book node using typed data.

Double price = 9.95;
DateTime date = new DateTime(2004, 5, 20);

using (XmlWriter writer = XmlWriter.Create("data.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteStartAttribute("pub-date");
    writer.WriteValue(date);
    writer.WriteEndAttribute();

    writer.WriteStartElement("price");
    writer.WriteValue(price);
    writer.WriteEndElement();

    writer.WriteEndElement();
    writer.Flush();
}
Dim price As [Double] = 9.95
Dim [date] As New DateTime(2004, 5, 20)
        
Using writer As XmlWriter = XmlWriter.Create("data.xml")
  writer.WriteStartElement("book")
  writer.WriteStartAttribute("pub-date")
  writer.WriteValue([date])
  writer.WriteEndAttribute()
            
  writer.WriteStartElement("price")
  writer.WriteValue(price)
  writer.WriteEndElement()
            
  writer.WriteEndElement()
  writer.Flush()
End Using

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(DateTimeOffset)

Scrive un valore DateTimeOffset.Writes a DateTimeOffset value.

public:
 virtual void WriteValue(DateTimeOffset value);
public virtual void WriteValue (DateTimeOffset value);
abstract member WriteValue : DateTimeOffset -> unit
override this.WriteValue : DateTimeOffset -> unit
Public Overridable Sub WriteValue (value As DateTimeOffset)

Parametri

value
DateTimeOffset

Valore DateTimeOffset da scrivere.The DateTimeOffset value to write.

Eccezioni

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Decimal)

Scrive un valore Decimal.Writes a Decimal value.

public:
 virtual void WriteValue(System::Decimal value);
public virtual void WriteValue (decimal value);
abstract member WriteValue : decimal -> unit
override this.WriteValue : decimal -> unit
Public Overridable Sub WriteValue (value As Decimal)

Parametri

value
Decimal

Valore Decimal da scrivere.The Decimal value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Double)

Scrive un valore Double.Writes a Double value.

public:
 virtual void WriteValue(double value);
public virtual void WriteValue (double value);
abstract member WriteValue : double -> unit
override this.WriteValue : double -> unit
Public Overridable Sub WriteValue (value As Double)

Parametri

value
Double

Valore Double da scrivere.The Double value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Esempi

Nell'esempio seguente viene scritto un nodo libro utilizzando dati tipizzati.The following example writes a book node using typed data.

Double price = 9.95;
DateTime date = new DateTime(2004, 5, 20);

using (XmlWriter writer = XmlWriter.Create("data.xml"))
{
    writer.WriteStartElement("book");
    writer.WriteStartAttribute("pub-date");
    writer.WriteValue(date);
    writer.WriteEndAttribute();

    writer.WriteStartElement("price");
    writer.WriteValue(price);
    writer.WriteEndElement();

    writer.WriteEndElement();
    writer.Flush();
}
Dim price As [Double] = 9.95
Dim [date] As New DateTime(2004, 5, 20)
        
Using writer As XmlWriter = XmlWriter.Create("data.xml")
  writer.WriteStartElement("book")
  writer.WriteStartAttribute("pub-date")
  writer.WriteValue([date])
  writer.WriteEndAttribute()
            
  writer.WriteStartElement("price")
  writer.WriteValue(price)
  writer.WriteEndElement()
            
  writer.WriteEndElement()
  writer.Flush()
End Using

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Int32)

Scrive un valore Int32.Writes a Int32 value.

public:
 virtual void WriteValue(int value);
public virtual void WriteValue (int value);
abstract member WriteValue : int -> unit
override this.WriteValue : int -> unit
Public Overridable Sub WriteValue (value As Integer)

Parametri

value
Int32

Valore Int32 da scrivere.The Int32 value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Int64)

Scrive un valore Int64.Writes a Int64 value.

public:
 virtual void WriteValue(long value);
public virtual void WriteValue (long value);
abstract member WriteValue : int64 -> unit
override this.WriteValue : int64 -> unit
Public Overridable Sub WriteValue (value As Long)

Parametri

value
Int64

Valore Int64 da scrivere.The Int64 value to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Object)

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

public:
 virtual void WriteValue(System::Object ^ value);
public virtual void WriteValue (object value);
abstract member WriteValue : obj -> unit
override this.WriteValue : obj -> unit
Public Overridable Sub WriteValue (value As Object)

Parametri

value
Object

Valore dell'oggetto da scrivere.The object value to write.

Nota In .NET Framework 3.5 questo metodo accetta DateTimeOffset come parametro.Note With the release of the .NET Framework 3.5, this method accepts DateTimeOffset as a parameter.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

L'elemento value è null.The value is null.

Il writer è chiuso o nello stato di errore.The writer is closed or in error state.

-oppure--or-

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime (CLR) e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime (CLR) object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Se l'oggetto CLR è un tipo di elenco, IEnumerablead IListesempio, ICollectiono, viene considerato come una matrice del tipo di valore.If the CLR object is a list type such as IEnumerable, IList, or ICollection, it is treated as an array of the value type. Il XmlWriter converte il valore nelle rappresentazioni di stringa in base alle regole del tipo di dati XML Schema (XSD) e lo scrive WriteString usando il metodo.The XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Single)

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

public:
 virtual void WriteValue(float value);
public virtual void WriteValue (float value);
abstract member WriteValue : single -> unit
override this.WriteValue : single -> unit
Public Overridable Sub WriteValue (value As Single)

Parametri

value
Single

Numero a virgola mobile e precisione singola da scrivere.The single-precision floating-point number to write.

Eccezioni

È stato specificato un valore non valido.An invalid value was specified.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente.An XmlWriter method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato utilizzando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Quando viene chiamato il metodo WriteValue, il XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole dei tipi di dati XSD (XML Schema) e li scrive utilizzando il metodo WriteString.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio.If WriteValue is called multiple times in succession, the values are not delimited by a space. È necessario chiamare il metodo WriteWhitespace tra le chiamate a WriteValue per inserire uno spazio vuoto.You must call WriteWhitespace between calls to WriteValue to insert white space. Passare un tipo di matrice all' XmlWriter.WriteValue(Object) overload per scrivere una matrice di valori distinti.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Se questo metodo viene chiamato su un' XmlWriter istanza di che restituisce solo testo, il valore tipizzato viene serializzato in testo.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare WriteStringAsync il metodo.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

Si applica a