XmlWriter.WriteValue Metódus

Definíció

Névtér:: System.Xml

Szerelvények:: System.Xml.dll, System.Xml.ReaderWriter.dll

Szerelvények:: netstandard.dll, System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.ReaderWriter.dll

Szerelvény:: System.Xml.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egyetlen egyszerű típusú értéket ír.

Túlterhelések

Name	Description
WriteValue(Single)	Egy pontosságú lebegőpontos számot ír.
WriteValue(Object)	Az objektumérték írása.
WriteValue(Int64)	Int64 Értéket ír.
WriteValue(Int32)	Int32 Értéket ír.
WriteValue(Double)	Double Értéket ír.
WriteValue(String)	String Értéket ír.
WriteValue(DateTimeOffset)	DateTimeOffset Értéket ír.
WriteValue(DateTime)	DateTime Értéket ír.
WriteValue(Boolean)	Boolean Értéket ír.
WriteValue(Decimal)	Decimal Értéket ír.

Megjegyzések

A WriteValue metódus elfogadja a közös nyelvi futtatókörnyezet (CLR) egyszerű típusú értékeit, az XML-sémadefiníciós nyelv (XSD) adattípus-konverziós szabályainak megfelelően sztringre konvertálja őket, és a WriteString metódussal kiírja őket. Ez lehetővé teszi az egyszerű típusú értékek folyamatát minimális reparsing többletterheléssel, amikor adatokat ad át a , XPathDocumentés XmlReader objektumok közöttXmlWriter. Ez a képesség akkor is hasznos, ha egyszerű CLR-típusokat és példányokat XmlWriter kezel. A metódust WriteValue meghívhatja a gépelt érték írására az osztály metódusai XmlConvert helyett, hogy a beírt adatokat sztringértékké alakítsa, mielőtt kiírja őket.

Aszinkron műveletek esetén konvertálja a visszaadott WriteValue értéket sztringgé, és használja a metódust WriteStringAsync .

Az alábbi táblázat a CLR-típusoknak megfelelő alapértelmezett XSD-adattípusokat mutatja be.

Ha a CLR-objektum listatípus, például IEnumerable, IListvagy ICollection, akkor az értéktípus tömbjeként lesz kezelve.

CLR-típus	Alapértelmezett XSD-adattípus
System.Boolean	xsd:boolean
System.Byte**	xsd:egész szám
System.Byte tömb	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd:decimal
System.Double	xsd:double
System.Int16**	xsd:egész szám
System.Int32	xsd:egész szám
System.Int64	xsd:egész szám
System.Single	xsd:float
System.String	xsd:string
System.IO.TextReader	xsd:string
System.IO.BinaryReader	xsd:base64Binary

**Ezek a típusok nem CLS-kompatibilisek. Nem rendelkeznek megfelelő WriteValue módszerekkel.

WriteValue(Single)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Egy pontosságú lebegőpontos számot ír.

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)

Paraméterek

value: Single

Az írandó egypontos lebegőpontos szám.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

Ez a metódus a közös nyelvi futtatókörnyezet objektumot használja, és az XML-sémadefiníciós nyelv (XSD) adattípus-konvertálási szabályaival konvertálja a bemeneti értéket a kívánt kimeneti típusra.

WriteValue A metódus meghívásakor az XmlWriter érték az XML-séma (XSD) adattípus-szabályainak megfelelően sztringre alakítja át az értéket, és a metódus használatával WriteString írja ki.

Ha WriteValue egymás után többször is meghívják, az értékek nem térközzel vannak elválasztva. A szabad terület beszúrásához hívásokat kell kezdeményeznie WriteWhitespace a WriteValue hívások között. Adjon át egy tömbtípust a XmlWriter.WriteValue(Object) túlterhelésnek, hogy különböző értékeket tartalmazó tömböt írjon ki.

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(Object)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Az objektumérték írása.

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)

Paraméterek

value: Object

Az írandó objektumérték.

Note A .NET Framework 3.5 kiadásával ez a metódus a DateTimeOffset paraméterként fogadja el.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

ArgumentNullException

Az value van null.

InvalidOperationException

Az író bezárult vagy hibaállapotban van.

-vagy-

Megjegyzések

Ez a módszer a közös nyelvi futtatókörnyezet (CLR) objektumot használja, és az XML-sémadefiníciós nyelv (XSD) adattípus-konvertálási szabályaival konvertálja a bemeneti értéket a kívánt kimeneti típusra.

Ha a CLR-objektum egy listatípus, például IEnumerable, IListvagy ICollection, akkor az értéktípus tömbjeként lesz kezelve. Az XmlWriter érték az XML-séma (XSD) adattípus-szabályainak megfelelően konvertálja az értéket a sztringre, és a WriteString metódussal írja ki.

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(Int64)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Int64 Értéket ír.

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)

Paraméterek

value: Int64

Az Int64 írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(Int32)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Int32 Értéket ír.

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)

Paraméterek

value: Int32

Az Int32 írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(Double)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Double Értéket ír.

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)

Paraméterek

value: Double

Az Double írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Példák

Az alábbi példa beírt adatokkal ír egy könyvcsomópontot.

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

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(String)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

String Értéket ír.

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)

Paraméterek

value: String

Az String írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletekhez használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(DateTimeOffset)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

DateTimeOffset Értéket ír.

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)

Paraméterek

value: DateTimeOffset

Az DateTimeOffset írandó érték.

Kivételek

InvalidOperationException

Megjegyzések

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(DateTime)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

DateTime Értéket ír.

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)

Paraméterek

value: DateTime

Az DateTime írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Példák

Az alábbi példa beírt adatokkal ír egy könyvcsomópontot.

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

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(Boolean)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Boolean Értéket ír.

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)

Paraméterek

value: Boolean

Az Boolean írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

WriteValue(Decimal)

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Forrás:: XmlWriter.cs

Decimal Értéket ír.

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)

Paraméterek

value: Decimal

Az Decimal írandó érték.

Kivételek

ArgumentException

Érvénytelen érték lett megadva.

InvalidOperationException

Megjegyzések

Ha ezt a metódust olyan XmlWriter példányon hívják meg, amely csak szöveges kimenetet ad ki, a beírt érték szerializálva lesz szöveggé.

Aszinkron műveletek esetén konvertálja a metódus visszatérési értékét sztringgé, és használja a metódust WriteStringAsync .

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?