XmlWriter.WriteValue Méthode

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

Exceptions

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.

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

Exceptions

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.

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

Exceptions

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.

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

Exceptions

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.

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

Exceptions

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.

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

Exceptions

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.

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

Exceptions

Remarques

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

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

Exceptions

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.

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

Exceptions

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.

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

Exceptions

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.