XmlWriter.WriteValue Méthode

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

É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 .

WriteValue(Single)

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

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.

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.

S’applique à

WriteValue(Object)

Écrit la valeur de l'objet.

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.

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 -

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.

S’applique à

WriteValue(Int64)

Écrit une valeur Int64.

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.

Exceptions

ArgumentException

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

InvalidOperationException

Remarques

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.

S’applique à

WriteValue(Int32)

Écrit une valeur Int32.

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.

Exceptions

ArgumentException

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

InvalidOperationException

Remarques

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.

S’applique à

WriteValue(Double)

Écrit une valeur Double.

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.

Exceptions

ArgumentException

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

InvalidOperationException

Exemples

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

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

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.

S’applique à

WriteValue(String)

Écrit une valeur String.

public:
 virtual void WriteValue(System::String ^ value);

public virtual void WriteValue (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.

Exceptions

ArgumentException

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

InvalidOperationException

Remarques

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.

S’applique à

WriteValue(DateTimeOffset)

Écrit une valeur DateTimeOffset.

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.

Exceptions

InvalidOperationException

Remarques

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

S’applique à

WriteValue(DateTime)

Écrit une valeur DateTime.

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.

Exceptions

ArgumentException

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

InvalidOperationException

Exemples

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

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

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.

S’applique à

WriteValue(Boolean)

Écrit une valeur Boolean.

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.

Exceptions

ArgumentException

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

InvalidOperationException

Remarques

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.

S’applique à

WriteValue(Decimal)

Écrit une valeur Decimal.

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.

Exceptions

ArgumentException

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

InvalidOperationException

Remarques

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.

S’applique à

XmlWriter.WriteValue Méthode

Définition

Surcharges

Remarques

WriteValue(Single)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(Object)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(Int64)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(Int32)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(Double)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

WriteValue(String)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(DateTimeOffset)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(DateTime)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

WriteValue(Boolean)

Paramètres

Exceptions

Remarques

S’applique à

WriteValue(Decimal)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires