XmlWriter.WriteValue Methode

Definitie

Naamruimte:: System.Xml

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

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee schrijft u één eenvoudig getypte waarde.

Overloads

Name	Description
WriteValue(Single)	Hiermee schrijft u een drijvendekommagetal met één precisie.
WriteValue(Object)	Hiermee schrijft u de objectwaarde.
WriteValue(Int64)	Hiermee schrijft u een Int64 waarde.
WriteValue(Int32)	Hiermee schrijft u een Int32 waarde.
WriteValue(Double)	Hiermee schrijft u een Double waarde.
WriteValue(String)	Hiermee schrijft u een String waarde.
WriteValue(DateTimeOffset)	Hiermee schrijft u een DateTimeOffset waarde.
WriteValue(DateTime)	Hiermee schrijft u een DateTime waarde.
WriteValue(Boolean)	Hiermee schrijft u een Boolean waarde.
WriteValue(Decimal)	Hiermee schrijft u een Decimal waarde.

Opmerkingen

De WriteValue methode accepteert common language runtime (CLR) eenvoudig getypte waarden, converteert ze naar de tekenreeksweergaven op basis van de XSD-regels (XML Schema Definition Language) voor gegevenstypen en schrijft deze uit met behulp van de WriteString methode. Hiermee kunt u eenvoudige waarden pijplijnen met minimale hersteloverhead bij het doorgeven van gegevens tussen XPathDocument, XmlReaderen XmlWriter objecten. Deze mogelijkheid is ook handig bij het omgaan met eenvoudige CLR-typen en een XmlWriter exemplaar. U kunt de WriteValue methode aanroepen om de getypte waarde te schrijven in plaats van de methoden in de XmlConvert klasse te gebruiken om de getypte gegevens te converteren naar een tekenreekswaarde voordat u deze opschrijft.

Voor asynchrone bewerkingen converteert u de retourwaarde van WriteValue naar een tekenreeks en gebruikt u de WriteStringAsync methode.

In de volgende tabel ziet u de standaard XSD-gegevenstypen die overeenkomen met CLR-typen.

Als het CLR-object een lijsttype is, zoals IEnumerable, IListof ICollection, wordt het beschouwd als een matrix van het waardetype.

CLR-type	Standaard XSD-gegevenstype
System.Boolean	xsd:booleaanse waarde
System.Byte**	xsd:integer
System.Byte Array	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

**Deze typen zijn niet cls-compatibel. Ze hebben geen bijbehorende WriteValue methoden.

WriteValue(Single)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een drijvendekommagetal met één precisie.

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)

Parameters

value: Single

Het drijvendekommagetal met één precisie dat moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.

Opmerkingen

Deze methode gebruikt het algemene runtime-object van de taal en converteert de invoerwaarde naar het gewenste uitvoertype met behulp van de xsD-regels (XML Schema Definition Language) voor gegevenstypen.

Wanneer de WriteValue methode wordt aangeroepen, converteert de XmlWriter waarde naar de tekenreeksweergaven volgens de regels voor het XML-schema (XSD) en schrijft deze uit met behulp van de WriteString methode.

Als WriteValue de waarden meerdere keren achter elkaar worden aangeroepen, worden de waarden niet gescheiden door een spatie. U moet bellen tussen aanroepen WriteWhitespace om witruimte in te WriteValue voegen. Geef een matrixtype door aan de XmlWriter.WriteValue(Object) overbelasting om een matrix met afzonderlijke waarden uit te schrijven.

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(Object)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u de objectwaarde.

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)

Parameters

value: Object

De objectwaarde die moet worden geschreven.

Note Met de release van het .NET Framework 3.5 accepteert deze methode DateTimeOffset als parameter.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

ArgumentNullException

De value is null.

InvalidOperationException

De schrijver is gesloten of heeft een foutstatus.

– of –

Opmerkingen

Deze methode gebruikt het CLR-object (Common Language Runtime) en converteert de invoerwaarde naar het gewenste uitvoertype met behulp van de XSD-regels (XML Schema Definition Language).

Als het CLR-object een lijsttype is, zoals IEnumerable, IListof ICollection, wordt het beschouwd als een matrix van het waardetype. De XmlWriter waarde wordt geconverteerd naar de tekenreeksweergaven volgens de XSD-gegevenstyperegels (XML Schema) en schrijft deze uit met behulp van de WriteString methode.

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(Int64)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een Int64 waarde.

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)

Parameters

value: Int64

De Int64 waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(Int32)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een Int32 waarde.

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)

Parameters

value: Int32

De Int32 waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(Double)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een Double waarde.

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)

Parameters

value: Double

De Double waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Voorbeelden

In het volgende voorbeeld wordt een boekknooppunt geschreven met behulp van getypte gegevens.

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

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(String)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een String waarde.

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)

Parameters

value: String

De String waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Gebruik de WriteStringAsync methode voor asynchrone bewerkingen.

Van toepassing op

WriteValue(DateTimeOffset)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een DateTimeOffset waarde.

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)

Parameters

value: DateTimeOffset

De DateTimeOffset waarde die moet worden geschreven.

Uitzonderingen

InvalidOperationException

Opmerkingen

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(DateTime)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een DateTime waarde.

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)

Parameters

value: DateTime

De DateTime waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Voorbeelden

In het volgende voorbeeld wordt een boekknooppunt geschreven met behulp van getypte gegevens.

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

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(Boolean)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een Boolean waarde.

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)

Parameters

value: Boolean

De Boolean waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

WriteValue(Decimal)

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Bron:: XmlWriter.cs

Hiermee schrijft u een Decimal waarde.

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)

Parameters

value: Decimal

De Decimal waarde die moet worden geschreven.

Uitzonderingen

ArgumentException

Er is een ongeldige waarde opgegeven.

InvalidOperationException

Opmerkingen

Als deze methode wordt aangeroepen op een XmlWriter exemplaar dat alleen tekst uitvoert, wordt de getypte waarde geserialiseerd naar tekst.

Voor asynchrone bewerkingen converteert u de retourwaarde van deze methode naar een tekenreeks en gebruikt u de WriteStringAsync methode.

Van toepassing op

Feedback

Is deze pagina nuttig?