XmlWriter.WriteValue XmlWriter.WriteValue XmlWriter.WriteValue XmlWriter.WriteValue Method

Definition

Schreibt einen einzelnen, einfach typisierten Wert.Writes a single simple-typed value.

Überlädt

WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Schreibt einen String-Wert.Writes a String value.

WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Schreibt einen Boolean-Wert.Writes a Boolean value.

WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Schreibt einen DateTime-Wert.Writes a DateTime value.

WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Schreibt einen DateTimeOffset-Wert.Writes a DateTimeOffset value.

WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Schreibt einen Decimal-Wert.Writes a Decimal value.

WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Schreibt einen Double-Wert.Writes a Double value.

WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Schreibt einen Int32-Wert.Writes a Int32 value.

WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Schreibt einen Int64-Wert.Writes a Int64 value.

WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

Schreibt den Objektwert.Writes the object value.

WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

Schreibt eine Gleitkommazahl mit einfacher Genauigkeit.Writes a single-precision floating-point number.

Hinweise

Die WriteValue Methode common Language Runtime (CLR) simpleType-Werte akzeptiert, konvertiert diese in ihre Zeichenfolgendarstellung entsprechend dem XML Schema Definition Language (XSD) Daten typkonvertierungsregeln und schreibt sie sich mit den WriteString -Methode.The WriteValue method accepts common language runtime (CLR) simple-typed values, converts them to their string representations according to the XML schema definition language (XSD) data type conversion rules, and writes them out by using the WriteString method. Dadurch können Sie die pipeline für Simple-Type-Werte, mit minimalen erneute Mehraufwand bei der Übergabe von Daten zwischen XPathDocument, XmlReader, und XmlWriter Objekte.This enables you to pipeline simple-type values with minimal reparsing overhead when passing data between XPathDocument, XmlReader, and XmlWriter objects. Diese Möglichkeit eignet sich auch beim Umgang mit einfachen CLR-Typen und eine XmlWriter Instanz.This ability is also useful when dealing with CLR simple-types and an XmlWriter instance. Rufen Sie die WriteValue -Methode, anstatt die Methoden in den typisierten Wert schreiben die XmlConvert Klasse, um die typisierten Daten in eine Zeichenfolge zu konvertieren, bevor Sie geschrieben wird.You can call the WriteValue method to write the typed value instead of using the methods in the XmlConvert class to convert the typed data to a string value before writing it out.

Konvertieren Sie für asynchrone Vorgänge ist den Rückgabewert von WriteValue auf eine Zeichenfolge, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of WriteValue to a string and use the WriteStringAsync method.

Die folgende Tabelle zeigt die XSD-Datentypen, die CLR-Typen entsprechen.The following table shows the default XSD data types that correspond to CLR types.

Wenn das CLR-Objekt ein Listentyp ist (z. B. IEnumerable, IList oder ICollection), wird es wie ein Array des Werttyps behandelt.If the CLR object is a list type, such as IEnumerable, IList, or ICollection, it is treated as an array of the value type.

CLR-TypCLR type Standard-XSD-DatentypDefault XSD data type
System.Boolean xsd:booleanxsd:boolean
System.Byte** xsd:integerxsd:integer
System.Byte-ArraySystem.Byte array xsd:base64Binaryxsd:base64Binary
System.Char** xsd:stringxsd:string
System.DateTime xsd:dateTimexsd:dateTime
System.Decimal xsd:decimalxsd:decimal
System.Double xsd:doublexsd:double
System.Int16** xsd:integerxsd:integer
System.Int32 xsd:integerxsd:integer
System.Int64 xsd:integerxsd:integer
System.Single xsd:floatxsd:float
System.String xsd:stringxsd:string
System.IO.TextReader xsd:stringxsd:string
System.IO.BinaryReader xsd:base64Binaryxsd:base64Binary

**Diese Typen sind nicht CLS-kompatibel.**These types are not CLS-compliant. Sie verfügen nicht über entsprechende WriteValue Methoden.They do not have corresponding WriteValue methods.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space.

WriteValue(String) WriteValue(String) WriteValue(String) WriteValue(String)

Schreibt einen String-Wert.Writes a String value.

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

value
String String String String

Der zu schreibende String-Wert.The String value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Verwenden Sie für asynchrone Vorgänge, die WriteStringAsync Methode.For asynchronous operations, use the WriteStringAsync method.

WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean) WriteValue(Boolean)

Schreibt einen Boolean-Wert.Writes a Boolean value.

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

value
Boolean Boolean Boolean Boolean

Der zu schreibende Boolean-Wert.The Boolean value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime) WriteValue(DateTime)

Schreibt einen DateTime-Wert.Writes a DateTime value.

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

value
DateTime DateTime DateTime DateTime

Der zu schreibende DateTime-Wert.The DateTime value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Beispiele

Im folgende Beispiel schreibt einen Buchknoten, die mithilfe von typisierter Daten.The following example writes a book node using typed data.

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 wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset) WriteValue(DateTimeOffset)

Schreibt einen DateTimeOffset-Wert.Writes a DateTimeOffset value.

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

value
DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset

Der zu schreibende DateTimeOffset-Wert.The DateTimeOffset value to write.

Ausnahmen

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal) WriteValue(Decimal)

Schreibt einen Decimal-Wert.Writes a Decimal value.

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

value
Decimal Decimal Decimal Decimal

Der zu schreibende Decimal-Wert.The Decimal value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Double) WriteValue(Double) WriteValue(Double) WriteValue(Double)

Schreibt einen Double-Wert.Writes a Double value.

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

value
Double Double Double Double

Der zu schreibende Double-Wert.The Double value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Beispiele

Im folgende Beispiel schreibt einen Buchknoten, die mithilfe von typisierter Daten.The following example writes a book node using typed data.

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 wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Int32) WriteValue(Int32) WriteValue(Int32) WriteValue(Int32)

Schreibt einen Int32-Wert.Writes a Int32 value.

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

value
Int32 Int32 Int32 Int32

Der zu schreibende Int32-Wert.The Int32 value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Int64) WriteValue(Int64) WriteValue(Int64) WriteValue(Int64)

Schreibt einen Int64-Wert.Writes a Int64 value.

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

value
Int64 Int64 Int64 Int64

Der zu schreibende Int64-Wert.The Int64 value to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Object) WriteValue(Object) WriteValue(Object) WriteValue(Object)

Schreibt den Objektwert.Writes the object value.

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

value
Object Object Object Object

Der zu schreibende Objektwert.The object value to write.

Hinweis Seit der Veröffentlichung von .NET Framework 3.5 akzeptiert diese Methode nun auch DateTimeOffset als Parameter.Note With the release of the .NET Framework 3.5, this method accepts DateTimeOffset as a parameter.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Der Writer ist geschlossen oder befindet sich im Fehlerzustand.The writer is closed or in error state.

- oder - -or-

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime (CLR) und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime (CLR) object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

Wenn das CLR-Objekt ein Listentyp wie IEnumerable, IList, oder ICollection, wird er als ein Array des Werttyps behandelt.If the CLR object is a list type such as IEnumerable, IList, or ICollection, it is treated as an array of the value type. Die XmlWriter konvertiert der Wert in die entsprechende Zeichenfolgendarstellung entsprechend dem Datentyp XML-Schema (XSD) Regeln und schreibt ihn mit der WriteString Methode.The XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

WriteValue(Single) WriteValue(Single) WriteValue(Single) WriteValue(Single)

Schreibt eine Gleitkommazahl mit einfacher Genauigkeit.Writes a single-precision floating-point number.

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

value
Single Single Single Single

Die zu schreibende Gleitkommazahl mit einfacher Genauigkeit.The single-precision floating-point number to write.

Ausnahmen

Es wurde ein ungültiger Wert angegeben.An invalid value was specified.

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde.An XmlWriter method was called before a previous asynchronous operation finished. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Hinweise

Diese Methode wird das Objekt der common Language Runtime und den Eingabewert auf den gewünschten Ausgabetyp, der mit der XML-Schema Definition Language (XSD) Konvertierungsregeln Datentyp konvertiert.This method takes the common language runtime object and converts the input value to the desired output type using the XML Schema definition language (XSD) data type conversion rules.

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.When the WriteValue method is called, the XmlWriter converts the value to its string representations according to the XML Schema (XSD) data type rules and writes it out using the WriteString method.

Wenn WriteValue mehrmals hintereinander aufgerufen wird, werden die Werte nicht durch Leerzeichen getrennt.If WriteValue is called multiple times in succession, the values are not delimited by a space. Wenn Leeraum eingefügt werden soll, müssen Sie zwischen Aufrufen von WriteWhitespace die WriteValue-Methode aufrufen.You must call WriteWhitespace between calls to WriteValue to insert white space. Übergeben von Array-Typ, der XmlWriter.WriteValue(Object) -Überladung verwenden, um ein Array von unterschiedlichen Werten schreiben.Pass an array type to the XmlWriter.WriteValue(Object) overload to write out an array of distinct values.

Wenn diese Methode aufgerufen wird, auf eine XmlWriter -Instanz, Ausgaben, die nur-Text-, der typisierte Wert in Text serialisiert wird.If this method is called on an XmlWriter instance that outputs text-only, the typed value is serialized to text.

Für asynchrone Vorgänge ist den Rückgabewert dieser Methode in eine Zeichenfolge zu konvertieren, und Verwenden der WriteStringAsync Methode.For asynchronous operations, convert the return value of this method to a string and use the WriteStringAsync method.

Gilt für: