Partager via


XmlWriter.WriteValue Méthode

Définition

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

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

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

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

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

value a la valeur null.

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.

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

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

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(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

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

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(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

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

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.

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 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(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

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

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.

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

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.

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

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

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.

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 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(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

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

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(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

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

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 à