XmlWriter.WriteValue Methode

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das Common Language Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten auszuschreiben.

Wenn diese Methode für eine XmlWriter Instanz aufgerufen wird, die nur Text ausgibt, wird der typisierte Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge, und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das allgemeine Sprachlaufzeitobjekt (CLR) und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Wenn das CLR-Objekt ein Listentyp ist, z IEnumerable. B. , IListoder ICollection, wird es als Array des Werttyps behandelt. Der XmlWriter Wert konvertiert den Wert in seine Zeichenfolgendarstellungen gemäß den XML-Schemaregeln (XSD) und schreibt es mithilfe der WriteString Methode aus.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das allgemeine Sprach-Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten zu schreiben.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das allgemeine Sprach-Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten zu schreiben.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein Buchknoten mit eingegebenen Daten geschrieben.

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

Hinweise

Diese Methode verwendet das allgemeine Sprach-Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten zu schreiben.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das Common Language Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten auszuschreiben.

Wenn diese Methode für eine XmlWriter Instanz aufgerufen wird, die nur Text ausgibt, wird der typisierte Wert in Text serialisiert.

Verwenden Sie für asynchrone Vorgänge die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein Buchknoten mit eingegebenen Daten geschrieben.

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

Hinweise

Diese Methode verwendet das allgemeine Sprach-Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten zu schreiben.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das allgemeine Sprach-Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten zu schreiben.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.

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)

Parameter

Ausnahmen

Hinweise

Diese Methode verwendet das allgemeine Sprach-Runtime-Objekt und konvertiert den Eingabewert in den gewünschten Ausgabetyp mithilfe der XML-Schemadefinitionssprache (XSD)-Datentypkonvertierungsregeln.

Beim Aufruf der WriteValue-Methode konvertiert der XmlWriter den Wert gemäß den Konvertierungsregeln für XSD-Datentypen in die entsprechende Zeichenfolgendarstellung und schreibt ihn mit der WriteString-Methode.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen. Übergeben Sie einen Arraytyp an die XmlWriter.WriteValue(Object) Überladung, um ein Array mit unterschiedlichen Werten zu schreiben.

Wenn diese Methode auf einer XmlWriter Instanz aufgerufen wird, die textgeschützt ausgibt, wird der eingegebene Wert in Text serialisiert.

Konvertieren Sie für asynchrone Vorgänge den Rückgabewert dieser Methode in eine Zeichenfolge und verwenden Sie die WriteStringAsync Methode.