XmlWriter.WriteValue Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Écrit une seule valeur typée simple.

Surcharges

WriteValue(Single)	Écrit un nombre à virgule flottante simple précision.
WriteValue(Object)	Écrit la valeur de l'objet.
WriteValue(Int64)	Écrit une valeur Int64.
WriteValue(Int32)	Écrit une valeur Int32.
WriteValue(Double)	Écrit une valeur Double.
WriteValue(String)	Écrit une valeur String.
WriteValue(DateTimeOffset)	Écrit une valeur DateTimeOffset.
WriteValue(DateTime)	Écrit une valeur DateTime.
WriteValue(Boolean)	Écrit une valeur Boolean.
WriteValue(Decimal)	Écrit une valeur Decimal.

Remarques

La WriteValue méthode accepte les valeurs de type simple CLR (Common Language Runtime), 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 Language) et les écrit à l’aide de la WriteString méthode. Cela vous permet de pipeliner des valeurs de type simple avec une surcharge minimale d’analyse lors du passage de données entre XPathDocument, XmlReaderet XmlWriter des objets. Cette fonctionnalité est également utile lors du traitement des types simples CLR et d’une XmlWriter instance. Vous pouvez appeler la WriteValue méthode pour écrire la valeur typée au lieu d’utiliser les méthodes de la XmlConvert classe pour convertir les données typées en valeur de chaîne avant de l’écrire.

Pour les opérations asynchrones, convertissez la valeur de retour d’une WriteValue chaîne et utilisez la WriteStringAsync méthode.

Le tableau suivant présente les types de données XSD par défaut qui correspondent aux types CLR.

Si l'objet CLR est un type de liste, comme IEnumerable, IList ou ICollection, il est traité comme un tableau du type de valeur.

Type CLR	Type de données XSD par défaut
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
Tableau System.Byte	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd:decimal
System.Double	xsd:double
System.Int16**	xsd:integer
System.Int32	xsd:integer
System.Int64	xsd:integer
System.Single	xsd:float
System.String	xsd:string
System.IO.TextReader	xsd:string
System.IO.BinaryReader	xsd:base64Binary

**Ces types ne sont pas conformes CLS. Ils n’ont pas de méthodes correspondantes WriteValue .

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc.

WriteValue(Single)

Écrit un nombre à virgule flottante simple précision.

C#

public virtual void WriteValue (float value);

Paramètres

value

Single

Nombre à virgule flottante simple précision à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(Object)

Écrit la valeur de l'objet.

C#

public virtual void WriteValue (object value);

Paramètres

value

Object

Valeur de l'objet à écrire.

Remarque Avec le .NET Framework version 3.5, cette méthode accepte DateTimeOffset en tant que paramètre.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

ArgumentNullException

value a la valeur null.

InvalidOperationException

Le Writer est fermé ou a l'état d'erreur.

• ou -

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet CLR (Common Language Runtime) et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

Si l’objet CLR est un type de liste tel que IEnumerable, IListou ICollection, il est traité comme un tableau du type valeur. La XmlWriter valeur convertit la valeur en représentations de chaîne en fonction des règles de type de données XSD (XML Schema) et l’écrit à l’aide de la WriteString méthode.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(Int64)

Écrit une valeur Int64.

C#

public virtual void WriteValue (long value);

Paramètres

value

Int64

La valeur Int64 à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(Int32)

Écrit une valeur Int32.

C#

public virtual void WriteValue (int value);

Paramètres

value

Int32

La valeur Int32 à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(Double)

Écrit une valeur Double.

C#

public virtual void WriteValue (double value);

Paramètres

value

Double

La valeur Double à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant écrit un nœud de livre à l’aide de données typées.

C#

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();
}

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(String)

Écrit une valeur String.

C#

public virtual void WriteValue (string value);

C#

public virtual void WriteValue (string? value);

Paramètres

value

String

La valeur String à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, utilisez la WriteStringAsync méthode.

WriteValue(DateTimeOffset)

Écrit une valeur DateTimeOffset.

C#

public virtual void WriteValue (DateTimeOffset value);

Paramètres

value

DateTimeOffset

La valeur DateTimeOffset à écrire.

Exceptions

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(DateTime)

Écrit une valeur DateTime.

C#

public virtual void WriteValue (DateTime value);

Paramètres

value

DateTime

La valeur DateTime à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant écrit un nœud de livre à l’aide de données typées.

C#

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();
}

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(Boolean)

Écrit une valeur Boolean.

C#

public virtual void WriteValue (bool value);

Paramètres

value

Boolean

La valeur Boolean à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.

WriteValue(Decimal)

Écrit une valeur Decimal.

C#

public virtual void WriteValue (decimal value);

Paramètres

value

Decimal

La valeur Decimal à écrire.

Exceptions

ArgumentException

Une valeur non valide a été spécifiée.

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode prend l’objet Common Language Runtime et convertit la valeur d’entrée en type de sortie souhaité à l’aide des règles de conversion de type de données XSD (XML Schema Definition Language).

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.

Si la méthode WriteValue est appelée plusieurs fois de suite, les valeurs ne sont pas délimitées par un espace. Vous devez appeler la méthode WriteWhitespace entre les appels à la méthode WriteValue pour insérer un espace blanc. Transmettez un type de tableau à la XmlWriter.WriteValue(Object) surcharge pour écrire un tableau de valeurs distinctes.

Si cette méthode est appelée sur une XmlWriter instance qui génère du texte uniquement, la valeur typée est sérialisée en texte.

Pour les opérations asynchrones, convertissez la valeur de retour de cette méthode en chaîne et utilisez la WriteStringAsync méthode.