XmlWriter.WriteValue Método

Definición

Espacio de nombres:: System.Xml

Ensamblados:: System.Xml.dll, System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.dll

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe un solo valor de tipo simple.

Sobrecargas

Nombre	Description
WriteValue(String)	Escribe un String valor.
WriteValue(Boolean)	Escribe un Boolean valor.
WriteValue(DateTime)	Escribe un DateTime valor.
WriteValue(DateTimeOffset)	Escribe un DateTimeOffset valor.
WriteValue(Decimal)	Escribe un Decimal valor.
WriteValue(Double)	Escribe un Double valor.
WriteValue(Int32)	Escribe un Int32 valor.
WriteValue(Int64)	Escribe un Int64 valor.
WriteValue(Object)	Escribe el valor del objeto.
WriteValue(Single)	Escribe un número de punto flotante de precisión sencilla.

Comentarios

El WriteValue método acepta valores de tipo simple de Common Language Runtime (CLR), los convierte en representaciones de cadena según las reglas de conversión de tipos de datos del lenguaje de definición de esquemas XML (XSD) y las escribe mediante el WriteString método . Esto le permite canalizar valores de tipo simple con una sobrecarga mínima de reparsificación al pasar datos entre XPathDocumentobjetos , XmlReadery XmlWriter . Esta capacidad también es útil cuando se trabaja con tipos simples clR y una XmlWriter instancia. Puede llamar al WriteValue método para escribir el valor con tipo en lugar de usar los métodos de la XmlConvert clase para convertir los datos con tipo en un valor de cadena antes de escribirlos.

Para las operaciones asincrónicas, convierta el valor devuelto de WriteValue en una cadena y use el WriteStringAsync método .

En la tabla siguiente se muestran los tipos de datos XSD predeterminados que corresponden a los tipos CLR.

Si el objeto CLR es un tipo de lista, como IEnumerable, IListo ICollection, se trata como una matriz del tipo de valor.

Tipo CLR	Tipo de datos XSD predeterminado
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte arreglo	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

**Estos tipos no son compatibles con CLS. No tienen métodos correspondientes WriteValue .

Si WriteValue se llama varias veces en sucesión, los valores no se delimitan por un espacio. Debe llamar WriteWhitespace entre llamadas a para WriteValue insertar espacios en blanco.

WriteValue(String)

Escribe un String valor.

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)

Parámetros

value: String

Valor String que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Se llamó a un XmlWriter método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

Comentarios

Este método toma el objeto Common Language Runtime y convierte el valor de entrada en el tipo de salida deseado mediante las reglas de conversión de tipos de datos del lenguaje de definición de esquemas XML (XSD).

Si WriteValue se llama varias veces en sucesión, los valores no se delimitan por un espacio. Debe llamar WriteWhitespace entre llamadas a para WriteValue insertar espacios en blanco. Pase un tipo de matriz a la XmlWriter.WriteValue(Object) sobrecarga para escribir una matriz de valores distintos.

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, use el WriteStringAsync método .

Se aplica a

WriteValue(Boolean)

Escribe un Boolean valor.

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)

Parámetros

value: Boolean

Valor Boolean que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Comentarios

Cuando se llama al WriteValue método , XmlWriter convierte el valor en sus representaciones de cadena según las reglas de tipo de datos del esquema XML (XSD) y lo escribe mediante el WriteString método .

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(DateTime)

Escribe un DateTime valor.

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)

Parámetros

value: DateTime

Valor DateTime que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Ejemplos

En el ejemplo siguiente se escribe un nodo de libro mediante datos con tipo.

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

Comentarios

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(DateTimeOffset)

Escribe un DateTimeOffset valor.

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)

Parámetros

value: DateTimeOffset

Valor DateTimeOffset que se va a escribir.

Excepciones

InvalidOperationException

Comentarios

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(Decimal)

Escribe un Decimal valor.

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)

Parámetros

value: Decimal

Valor Decimal que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Comentarios

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(Double)

Escribe un Double valor.

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)

Parámetros

value: Double

Valor Double que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Ejemplos

En el ejemplo siguiente se escribe un nodo de libro mediante datos con tipo.

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

Comentarios

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(Int32)

Escribe un Int32 valor.

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)

Parámetros

value: Int32

Valor Int32 que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Comentarios

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(Int64)

Escribe un Int64 valor.

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)

Parámetros

value: Int64

Valor Int64 que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Comentarios

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(Object)

Escribe el valor del objeto.

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)

Parámetros

value: Object

Valor del objeto que se va a escribir.

Note Con la versión de .NET Framework 3.5, este método acepta DateTimeOffset como parámetro.

Excepciones

ArgumentException

Se especificó un valor no válido.

ArgumentNullException

El value es null.

InvalidOperationException

El escritor está cerrado o en estado de error.

O bien

Comentarios

Este método toma el objeto de Common Language Runtime (CLR) y convierte el valor de entrada en el tipo de salida deseado mediante las reglas de conversión de tipos de datos del lenguaje de definición de esquemas XML (XSD).

Si el objeto CLR es un tipo de lista como IEnumerable, IListo ICollection, se trata como una matriz del tipo de valor. XmlWriter convierte el valor en sus representaciones de cadena según las reglas de tipo de datos del esquema XML (XSD) y la escribe mediante el WriteString método .

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

WriteValue(Single)

Escribe un número de punto flotante de precisión sencilla.

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)

Parámetros

value: Single

Número de punto flotante de precisión sencilla que se va a escribir.

Excepciones

ArgumentException

Se especificó un valor no válido.

InvalidOperationException

Comentarios

Si se llama a este método en una XmlWriter instancia que genera solo texto, el valor con tipo se serializa en texto.

Para las operaciones asincrónicas, convierta el valor devuelto de este método en una cadena y use el WriteStringAsync método .

Se aplica a

Comentarios

¿Le ha resultado útil esta página?