XmlWriter.WriteValue Metodo

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scrive un singolo valore tipizzato semplice.

Overload

Nome	Descrizione
WriteValue(String)	Scrive un String valore.
WriteValue(Boolean)	Scrive un Boolean valore.
WriteValue(DateTime)	Scrive un DateTime valore.
WriteValue(DateTimeOffset)	Scrive un DateTimeOffset valore.
WriteValue(Decimal)	Scrive un Decimal valore.
WriteValue(Double)	Scrive un Double valore.
WriteValue(Int32)	Scrive un Int32 valore.
WriteValue(Int64)	Scrive un Int64 valore.
WriteValue(Object)	Scrive il valore dell'oggetto.
WriteValue(Single)	Scrive un numero a virgola mobile e precisione singola.

Commenti

Il WriteValue metodo accetta valori simple typed clr (Common Language Runtime), li converte nelle relative rappresentazioni di stringa in base alle regole di conversione dei tipi di dati XSD (XML Schema Definition Language) e le scrive usando il WriteString metodo . In questo modo è possibile eseguire la pipeline di valori di tipo semplice con un sovraccarico minimo di analisi quando si passano dati tra XPathDocumentoggetti , XmlReadere XmlWriter . Questa capacità è utile anche quando si gestiscono tipi clr semplici e un'istanza XmlWriter di . È possibile chiamare il WriteValue metodo per scrivere il valore tipizzato anziché usare i metodi nella XmlConvert classe per convertire i dati tipizzato in un valore stringa prima di scriverli.

Per le operazioni asincrone, convertire il valore restituito di WriteValue in una stringa e usare il WriteStringAsync metodo .

Nella tabella seguente vengono illustrati i tipi di dati XSD predefiniti che corrispondono ai tipi CLR.

Se l'oggetto CLR è un tipo di elenco, ad esempio IEnumerable, IListo ICollection, viene considerato come una matrice del tipo valore.

Tipo CLR	Tipo di dati XSD predefinito
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte Matrice	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

**Questi tipi non sono conformi a CLS. Non dispongono di metodi corrispondenti WriteValue .

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio. È necessario chiamare WriteWhitespace tra le chiamate a per WriteValue inserire spazi vuoti.

WriteValue(String)

Scrive un String valore.

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)

Parametri

value: String

Valore String da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

È stato chiamato un XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".

Commenti

Questo metodo accetta l'oggetto Common Language Runtime e converte il valore di input nel tipo di output desiderato usando le regole di conversione dei tipi di dati XSD (XML Schema Definition Language).

Se WriteValue viene chiamato più volte in successione, i valori non sono delimitati da uno spazio. È necessario chiamare WriteWhitespace tra le chiamate a per WriteValue inserire spazi vuoti. Passare un tipo di matrice all'overload XmlWriter.WriteValue(Object) per scrivere una matrice di valori distinti.

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, usare il WriteStringAsync metodo .

Si applica a

WriteValue(Boolean)

Scrive un Boolean valore.

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)

Parametri

value: Boolean

Valore Boolean da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Commenti

Quando viene chiamato il WriteValue metodo , XmlWriter converte il valore nelle relative rappresentazioni di stringa in base alle regole del tipo di dati XSD (XML Schema) e lo scrive usando il WriteString metodo .

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(DateTime)

Scrive un DateTime valore.

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)

Parametri

value: DateTime

Valore DateTime da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Esempio

Nell'esempio seguente viene scritto un nodo libro usando dati tipizzato.

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

Commenti

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(DateTimeOffset)

Scrive un DateTimeOffset valore.

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)

Parametri

value: DateTimeOffset

Valore DateTimeOffset da scrivere.

Eccezioni

InvalidOperationException

Commenti

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(Decimal)

Scrive un Decimal valore.

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)

Parametri

value: Decimal

Valore Decimal da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Commenti

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(Double)

Scrive un Double valore.

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)

Parametri

value: Double

Valore Double da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Esempio

Nell'esempio seguente viene scritto un nodo libro usando dati tipizzato.

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

Commenti

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(Int32)

Scrive un Int32 valore.

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)

Parametri

value: Int32

Valore Int32 da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Commenti

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(Int64)

Scrive un Int64 valore.

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)

Parametri

value: Int64

Valore Int64 da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Commenti

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(Object)

Scrive il valore dell'oggetto.

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)

Parametri

value: Object

Valore dell'oggetto da scrivere.

Note Con la versione di .NET Framework 3.5, questo metodo accetta DateTimeOffset come parametro.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

ArgumentNullException

Il value è null.

InvalidOperationException

Il writer è chiuso o in stato di errore.

oppure

Commenti

Questo metodo accetta l'oggetto CLR (Common Language Runtime) e converte il valore di input nel tipo di output desiderato usando le regole di conversione del tipo di dati XSD (XML Schema Definition Language).

Se l'oggetto CLR è un tipo di elenco, IEnumerablead esempio , IListo ICollection, viene considerato come una matrice del tipo valore. XmlWriter Converte il valore nelle relative rappresentazioni di stringa in base alle regole del tipo di dati XSD (XML Schema) e lo scrive usando il WriteString metodo .

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

WriteValue(Single)

Scrive un numero a virgola mobile e precisione singola.

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)

Parametri

value: Single

Numero a virgola mobile e precisione singola da scrivere.

Eccezioni

ArgumentException

È stato specificato un valore non valido.

InvalidOperationException

Commenti

Se questo metodo viene chiamato su un'istanza XmlWriter che restituisce solo testo, il valore tipizzato viene serializzato in testo.

Per le operazioni asincrone, convertire il valore restituito di questo metodo in una stringa e usare il WriteStringAsync metodo .

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?