XmlWriter.WriteValue Método

Definição

Namespace:: System.Xml

Assemblies:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Grava um único valor de tipo simples.

Sobrecargas

Nome	Description
WriteValue(String)	Grava um String valor.
WriteValue(Boolean)	Grava um Boolean valor.
WriteValue(DateTime)	Grava um DateTime valor.
WriteValue(DateTimeOffset)	Grava um DateTimeOffset valor.
WriteValue(Decimal)	Grava um Decimal valor.
WriteValue(Double)	Grava um Double valor.
WriteValue(Int32)	Grava um Int32 valor.
WriteValue(Int64)	Grava um Int64 valor.
WriteValue(Object)	Grava o valor do objeto.
WriteValue(Single)	Grava um número de ponto flutuante de precisão única.

Comentários

O WriteValue método aceita valores de tipo simples clr (common language runtime), converte-os em suas representações de cadeia de caracteres de acordo com as regras de conversão de tipo de dados XSD (linguagem de definição de esquema XML) e grava-os usando o WriteString método. Isso permite que você pipeline valores de tipo simples com sobrecarga de nova análise mínima ao passar dados entre XPathDocument, XmlReadere XmlWriter objetos. Essa capacidade também é útil ao lidar com tipos simples clr e uma XmlWriter instância. Você pode chamar o WriteValue método para gravar o valor digitado em vez de usar os métodos na classe para converter os dados digitado em XmlConvert um valor de cadeia de caracteres antes de escrevê-lo.

Para operações assíncronas, converta o valor retornado em uma cadeia de WriteValue caracteres e use o WriteStringAsync método.

A tabela a seguir mostra os tipos de dados XSD padrão que correspondem aos tipos CLR.

Se o objeto CLR for um tipo de lista, como IEnumerable, IListou ICollection, ele será tratado como uma matriz do tipo de valor.

Tipo CLR	Tipo de dados XSD padrão
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte matriz	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

**Esses tipos não são compatíveis com CLS. Eles não têm métodos correspondentes WriteValue .

Se WriteValue for chamado várias vezes consecutivas, os valores não serão delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas para WriteValue inserir espaço em branco.

WriteValue(String)

Grava um 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

O String valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um XmlWriter método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

Comentários

Esse método usa o objeto common language runtime e converte o valor de entrada no tipo de saída desejado usando as regras de conversão de tipo de dados XSD (linguagem de definição de esquema XML).

Se WriteValue for chamado várias vezes consecutivas, os valores não serão delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas para WriteValue inserir espaço em branco. Passe um tipo de matriz para a XmlWriter.WriteValue(Object) sobrecarga para gravar uma matriz de valores distintos.

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, use o WriteStringAsync método.

Aplica-se a

WriteValue(Boolean)

Grava um 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

O Boolean valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Comentários

Quando o WriteValue método é chamado, o XmlWriter valor é convertido em suas representações de cadeia de caracteres de acordo com as regras de tipo de dados XSD (Esquema XML) e grava-o usando o WriteString método.

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(DateTime)

Grava um 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

O DateTime valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Exemplos

O exemplo a seguir grava um nó de livro usando dados digitadas.

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

Comentários

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(DateTimeOffset)

Grava um 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

O DateTimeOffset valor a ser gravado.

Exceções

InvalidOperationException

Comentários

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(Decimal)

Grava um 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

O Decimal valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Comentários

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(Double)

Grava um 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

O Double valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Exemplos

O exemplo a seguir grava um nó de livro usando dados digitadas.

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

Comentários

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(Int32)

Grava um 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

O Int32 valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Comentários

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(Int64)

Grava um 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

O Int64 valor a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Comentários

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(Object)

Grava o valor do 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

O valor do objeto a ser gravado.

Note Com a versão do .NET Framework 3.5, esse método aceita DateTimeOffset como parâmetro.

Exceções

ArgumentException

Um valor inválido foi especificado.

ArgumentNullException

O value é null.

InvalidOperationException

O gravador está fechado ou em estado de erro.

-ou-

Comentários

Esse método usa o objeto CLR (Common Language Runtime) e converte o valor de entrada no tipo de saída desejado usando as regras de conversão de tipo de dados XSD (linguagem de definição de esquema XML).

Se o objeto CLR for um tipo de lista, como IEnumerable, IListou ICollection, ele será tratado como uma matriz do tipo de valor. O XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras de tipo de dados XSD (Esquema XML) e grava-o usando o WriteString método.

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

WriteValue(Single)

Grava um número de ponto flutuante de precisão única.

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

O número de ponto flutuante de precisão única a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Comentários

Se esse método for chamado em uma XmlWriter instância que gera somente texto, o valor digitado será serializado em texto.

Para operações assíncronas, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

Aplica-se a

Comentários

Esta página foi útil?