XmlWriter.WriteValue Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Grava um único valor de tipo simples.

Sobrecargas

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

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 clr simples e uma XmlWriter instância. Você pode chamar o WriteValue método para gravar o valor tipado em vez de usar os métodos na XmlConvert classe para converter os dados tipado em 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 é um tipo de lista, como IEnumerable, IList, ou ICollection, é tratado como uma matriz de tipo de valor.

Tipo CLR	Tipo de dados XSD padrão
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
Matriz System.Byte	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 é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o espaço em branco.

WriteValue(Single)

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

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 simples a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado 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 para o tipo de saída desejado usando as regras de conversão de tipo de dados XSD (linguagem de definição de esquema XML).

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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, converta o valor retornado desse método em uma cadeia de caracteres e use o WriteStringAsync método.

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.

Observação na versão .NET Framework 3.5, esse método aceita DateTimeOffset como um 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 -

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

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 XML Schema (XSD) 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 para texto.

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

WriteValue(Int64)

Grava um valor Int64.

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 valor Int64 a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado 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).

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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 para texto.

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

WriteValue(Int32)

Grava um valor Int32.

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 valor Int32 a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado 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).

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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 para texto.

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

WriteValue(Double)

Grava um valor Double.

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 valor Double a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

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

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

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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 para texto.

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

WriteValue(String)

Grava um valor String.

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)

Parâmetros

value

String

O valor String a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado 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 para o 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 é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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.

WriteValue(DateTimeOffset)

Grava um valor DateTimeOffset.

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 valor DateTimeOffset a ser gravado.

Exceções

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

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.

WriteValue(DateTime)

Grava um valor DateTime.

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 valor DateTime a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

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

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

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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 para texto.

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

WriteValue(Boolean)

Grava um valor Boolean.

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 valor Boolean a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado 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).

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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 para texto.

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

WriteValue(Decimal)

Grava um valor Decimal.

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 valor Decimal a ser gravado.

Exceções

ArgumentException

Um valor inválido foi especificado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado 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).

Quando o método de WriteValue é chamado, XmlWriter converte o valor em suas representações de cadeia de caracteres de acordo com as regras e grava o tipo de dados de (XSD) de esquema XML ele usa para fora o método de WriteString .

Se WriteValue é chamado várias vezes sucessivamente, os valores não são delimitados por um espaço. Você deve chamar WriteWhitespace entre chamadas a WriteValue para inserir o 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 para texto.

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