XmlWriter.WriteValue Método

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.

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

Exceções

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.