XmlWriter.WriteValue Méthode

Définition

Espace de noms:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

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 valeur simple typée.

Surcharges

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

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 d’analyse minimale lors du passage de données entre les XPathDocumentobjets et XmlReader les XmlWriterobjets. Cette capacité 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 montre les types de données XSD par défaut qui correspondent aux types CLR.

Si l’objet CLR est un type de liste, tel que IEnumerable, IListou ICollection, il est traité comme un tableau du type valeur.

Type CLR	Type de données XSD par défaut
System.Boolean	xsd :boolean
System.Byte**	xsd :integer
System.Byte tableau	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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

É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 XmlWriter méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, 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).

Lorsque la WriteValue méthode est appelée, la XmlWriter valeur est convertie en représentations sous forme de chaîne en fonction des règles de type de données XSD (XML Schema) et les écrit à l’aide de la WriteString méthode.

Si WriteValue elle est appelée plusieurs fois par succession, les valeurs ne sont pas délimitées par un espace. Vous devez appeler WriteWhitespace entre les appels pour WriteValue 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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

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

Note Avec la publication du .NET Framework 3.5, cette méthode accepte DateTimeOffset comme paramètre.

Exceptions

ArgumentException

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

ArgumentNullException

value a la valeur null.

InvalidOperationException

L’enregistreur est fermé ou dans un é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. Convertit XmlWriter la valeur en ses représentations sous forme de chaîne en fonction des règles de type de données XSD (XML Schema) et les é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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une Int64 valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une Int32 valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une Double valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une String valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une DateTimeOffset valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une DateTime valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une Boolean valeur.

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

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)

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Source:: XmlWriter.cs

Écrit une Decimal valeur.

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

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 à

Commentaires

Cette page a-t-elle été utile ?