XmlWriter.WriteValue Método

Definição

Espaço de Nomes:: System.Xml

Assemblagens:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assemblagens:: netstandard.dll, System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Escreve um único valor tipo simples.

Sobrecargas

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

Observações

O WriteValue método aceita valores de tipo simples em tempo de execução da common language (CLR), converte-os para as suas representações de string de acordo com as regras de conversão de tipos de dados XML schema definition language (XSD) e escreve-os utilizando o WriteString método. Isto permite-lhe pipelinear valores de tipo simples com uma sobrecarga de análise mínima ao passar dados entre XPathDocument, XmlReader, e XmlWriter objetos. Esta capacidade também é útil ao lidar com tipos simples CLR e uma XmlWriter instância. Podes chamar o WriteValue método para escrever o valor tipado em vez de usar os métodos da XmlConvert classe para converter os dados tipados num valor de cadeia antes de o escrever.

Para operações assíncronas, converte o valor de retorno de WriteValue para uma cadeia e utiliza o WriteStringAsync método.

A tabela seguinte mostra os tipos de dados XSD predefinidos que correspondem aos tipos CLR.

Se o objeto CLR for um tipo de lista, como IEnumerable, IList, ou ICollection, é tratado como um array do tipo de valor.

Tipo CLR	Tipo de dado XSD predefinido
System.Boolean	xsd:booleano
System.Byte**	xsd:inteiro
System.Byte matriz	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dataHora
System.Decimal	xsd:decimal
System.Double	XSD:Duplo
System.Int16**	xsd:inteiro
System.Int32	xsd:inteiro
System.Int64	xsd:inteiro
System.Single	xsd:float
System.String	xsd:string
System.IO.TextReader	xsd:string
System.IO.BinaryReader	xsd:base64Binary

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

Se WriteValue for chamado várias vezes em sucessão, os valores não são delimitados por um espaço. Deve ligar WriteWhitespace entre chamadas para WriteValue inserir espaço em branco.

WriteValue(Single)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Um XmlWriter método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

Este método pega no objeto de execução da common language e converte o valor de entrada para o tipo de saída desejado usando as regras de conversão de tipos de dados XML Schema Definition Language (XSD).

Quando o WriteValue método é chamado, converte XmlWriter o valor para as suas representações de string de acordo com as regras de tipo de dados XML Schema (XSD) e escreve-o usando o WriteString método.

Se WriteValue for chamado várias vezes em sucessão, os valores não são delimitados por um espaço. Deve ligar WriteWhitespace entre chamadas para WriteValue inserir espaço em branco. Passa um tipo de array para a XmlWriter.WriteValue(Object) sobrecarga para escrever um array de valores distintos.

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(Object)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Note Com o lançamento do .NET Framework 3.5, este método aceita DateTimeOffset como parâmetro.

Exceções

ArgumentException

Foi especificado um valor inválido.

ArgumentNullException

O value é null.

InvalidOperationException

O autor está fechado ou em estado de erro.

-ou-

Observações

Este método pega no objeto common language runtime (CLR) e converte o valor de entrada para o tipo de saída desejado usando as regras de conversão de tipos de dados XML Schema Definition Language (XSD).

Se o objeto CLR for um tipo de lista como IEnumerable, IList, ou ICollection, é tratado como um array do tipo de valor. Converte XmlWriter o valor para as suas representações de cadeia de acordo com as regras de tipo de dados XML Schema (XSD) e escreve-o usando o WriteString método.

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(Int64)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(Int32)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(Double)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Exemplos

O exemplo seguinte escreve um nó livro usando dados tipados.

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

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(String)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve um String valor.

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 String valor a escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

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

Aplica-se a

WriteValue(DateTimeOffset)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

InvalidOperationException

Observações

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(DateTime)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Exemplos

O exemplo seguinte escreve um nó livro usando dados tipados.

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

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(Boolean)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

WriteValue(Decimal)

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Origem:: XmlWriter.cs

Escreve 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 escrever.

Exceções

ArgumentException

Foi especificado um valor inválido.

InvalidOperationException

Observações

Se este método for chamado numa XmlWriter instância que gera apenas texto, o valor tipado é serializado para texto.

Para operações assíncronas, converte o valor de retorno deste método para uma cadeia e usa o WriteStringAsync método.

Aplica-se a

Comentários

Esta página foi útil?