XmlWriter.WriteValue Méthode

Définition

Écrit une seule valeur typée simple.Writes a single simple-typed value.

Surcharges

WriteValue(Single)

Écrit un nombre à virgule flottante simple précision.Writes a single-precision floating-point number.

WriteValue(Object)

Écrit la valeur de l'objet.Writes the object value.

WriteValue(Int64)

Écrit une valeur Int64.Writes a Int64 value.

WriteValue(Int32)

Écrit une valeur Int32.Writes a Int32 value.

WriteValue(Double)

Écrit une valeur Double.Writes a Double value.

WriteValue(String)

Écrit une valeur String.Writes a String value.

WriteValue(DateTimeOffset)

Écrit une valeur DateTimeOffset.Writes a DateTimeOffset value.

WriteValue(DateTime)

Écrit une valeur DateTime.Writes a DateTime value.

WriteValue(Boolean)

Écrit une valeur Boolean.Writes a Boolean value.

WriteValue(Decimal)

Écrit une valeur Decimal.Writes a Decimal value.

Remarques

La WriteValue méthode accepte les valeurs de type simple Common Language Runtime (CLR), les convertit en leurs représentations sous forme de chaîne en fonction des règles de conversion de type de données XSD (XML Schema Definition) et les écrit à l’aide de la WriteString méthode.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. Cela vous permet de canaliser les valeurs de type simple avec une surcharge de réanalyse minimale lors du passage de données entre XPathDocument des XmlReader objets, et XmlWriter .This enables you to pipeline simple-type values with minimal reparsing overhead when passing data between XPathDocument, XmlReader, and XmlWriter objects. Cette fonctionnalité est également utile lorsque vous traitez des types simples CLR et une XmlWriter instance.This ability is also useful when dealing with CLR simple-types and an XmlWriter instance. Vous pouvez appeler la WriteValue méthode pour écrire la valeur typée au lieu d’utiliser les méthodes dans la XmlConvert classe pour convertir les données typées en une valeur de chaîne avant de l’écrire.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.

Pour les opérations asynchrones, convertit la valeur de retour de WriteValue en une chaîne et utilise la WriteStringAsync méthode.For asynchronous operations, convert the return value of WriteValue to a string and use the WriteStringAsync method.

Le tableau suivant répertorie les types de données XSD par défaut qui correspondent aux types CLR.The following table shows the default XSD data types that correspond to CLR types.

Si l'objet CLR est un type de liste, comme IEnumerable, IList ou ICollection, il est traité comme un tableau du type de valeur.If the CLR object is a list type, such as IEnumerable, IList, or ICollection, it is treated as an array of the value type.

Type CLRCLR type Type de données XSD par défautDefault XSD data type
System.Boolean xsd:booleanxsd:boolean
System.Byte** xsd:integerxsd:integer
Tableau 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

**Ces types ne sont pas conformes CLS.**These types are not CLS-compliant. Ils n’ont pas de WriteValue méthodes correspondantes.They do not have corresponding WriteValue methods.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space.

WriteValue(Single)

Écrit un nombre à virgule flottante simple précision.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)

Paramètres

value
Single

Nombre à virgule flottante simple précision à écrire.The single-precision floating-point number to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Object)

Écrit la valeur de l'objet.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)

Paramètres

value
Object

Valeur de l'objet à écrire.The object value to write.

Remarque Avec le .NET Framework version 3.5, cette méthode accepte DateTimeOffset en tant que paramètre.Note With the release of the .NET Framework 3.5, this method accepts DateTimeOffset as a parameter.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

value a la valeur null.The value is null.

Le Writer est fermé ou a l'état d'erreur.The writer is closed or in error state.

- ou --or-

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime (CLR) et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Si l’objet CLR est un type de liste tel que IEnumerable , IList ou ICollection , il est traité comme un tableau du type valeur.If the CLR object is a list type such as IEnumerable, IList, or ICollection, it is treated as an array of the value type. XmlWriterConvertit la valeur en sa représentation sous forme de chaîne conformément aux règles de type de données XSD (XML Schema) et l’écrit à l’aide de la WriteString méthode.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.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Int64)

Écrit une valeur 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)

Paramètres

value
Int64

La valeur Int64 à écrire.The Int64 value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Int32)

Écrit une valeur 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)

Paramètres

value
Int32

La valeur Int32 à écrire.The Int32 value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Double)

Écrit une valeur 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)

Paramètres

value
Double

La valeur Double à écrire.The Double value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Exemples

L’exemple suivant écrit un nœud de livre à l’aide de données typées.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

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(String)

Écrit une valeur 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)

Paramètres

value
String

La valeur String à écrire.The String value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, utilisez la WriteStringAsync méthode.For asynchronous operations, use the WriteStringAsync method.

WriteValue(DateTimeOffset)

Écrit une valeur 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)

Paramètres

value
DateTimeOffset

La valeur DateTimeOffset à écrire.The DateTimeOffset value to write.

Exceptions

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(DateTime)

Écrit une valeur 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)

Paramètres

value
DateTime

La valeur DateTime à écrire.The DateTime value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Exemples

L’exemple suivant écrit un nœud de livre à l’aide de données typées.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

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Boolean)

Écrit une valeur 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)

Paramètres

value
Boolean

La valeur Boolean à écrire.The Boolean value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Decimal)

Écrit une valeur 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)

Paramètres

value
Decimal

La valeur Decimal à écrire.The Decimal value to write.

Exceptions

Une valeur non valide a été spécifiée.An invalid value was specified.

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente.An XmlWriter method was called before a previous asynchronous operation finished. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Remarques

Cette méthode prend l’objet common language runtime et convertit la valeur d’entrée dans le type de sortie souhaité à l’aide des règles de conversion de type de données 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.

Lors d'un appel à la méthode WriteValue, l'objet XmlWriter convertit la valeur en une représentation de chaîne en fonction des règles de type de données XSD (XML Schema Definition) et l'écrit à l'aide de la méthode 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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace.If WriteValue is called multiple times in succession, the values are not delimited by a space. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.You must call WriteWhitespace between calls to WriteValue to insert white space. Transmettez un type tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Si cette méthode est appelée sur une XmlWriter instance qui génère uniquement du texte, la valeur typée est sérialisée en texte.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en une chaîne et utilisez la WriteStringAsync méthode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

S’applique à