XmlWriter.WriteValue Metoda

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zapíše jednu jednoduchou hodnotu.

Přetížení

WriteValue(Single)	Zapíše jednopřesné číslo s plovoucí desetinou čárkou.
WriteValue(Object)	Zapíše hodnotu objektu.
WriteValue(Int64)	Int64 Zapíše hodnotu.
WriteValue(Int32)	Int32 Zapíše hodnotu.
WriteValue(Double)	Double Zapíše hodnotu.
WriteValue(String)	Zapíše String hodnotu.
WriteValue(DateTimeOffset)	DateTimeOffset Zapíše hodnotu.
WriteValue(DateTime)	DateTime Zapíše hodnotu.
WriteValue(Boolean)	Boolean Zapíše hodnotu.
WriteValue(Decimal)	Decimal Zapíše hodnotu.

Poznámky

Metoda WriteValue přijímá jednoduché hodnoty modulu CLR (Common Language Runtime), převede je na jejich řetězcové reprezentace podle pravidel převodu WriteString datových typů XSD (XML schema definition Language) a zapíše je pomocí metody. To vám umožní kanálovat hodnoty jednoduchého typu s minimální režií při předávání dat mezi XPathDocument, XmlReadera XmlWriter objekty. Tato schopnost je také užitečná při práci s jednoduchými typy CLR a XmlWriter instancí. Metodu můžete volat k WriteValue zápisu zadané hodnoty místo použití metod ve XmlConvert třídě k převodu zadaných dat na řetězcovou hodnotu před tím, než ji zapíšete.

V případě asynchronních operací převeďte návratovou hodnotu WriteValue na řetězec a použijte metodu WriteStringAsync .

Následující tabulka ukazuje výchozí datové typy XSD, které odpovídají typům CLR.

Pokud je objekt CLR typu seznamu, například IEnumerable, IListnebo ICollection, je považován za pole typu hodnoty.

Typ CLR	Výchozí datový typ XSD
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte Pole	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

**Tyto typy nedodržují předpisy CLS. Nemají odpovídající WriteValue metody.

Pokud WriteValue je volána vícekrát za sebou, hodnoty nejsou odděleny mezerou. Pokud chcete WriteValue vložit prázdné znaky, musíte volat WriteWhitespace mezi volání.

WriteValue(Single)

Zapíše jednopřesné číslo s plovoucí desetinou čárkou.

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)

Parametry

value: Single

Jednopřesné číslo s plovoucí desetinou čárkou pro zápis.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Poznámky

Tato metoda přebírá objekt modulu CLR (Common Language Runtime) a převede vstupní hodnotu na požadovaný výstupní typ pomocí pravidel převodu datových typů XSD (XML Schema Definition Language).

WriteValue Při volání XmlWriter metody převede hodnotu na jeho řetězcové reprezentace podle pravidel datového typu XML Schema (XSD) a zapíše ji pomocí WriteString metody.

Pokud WriteValue se volá vícekrát za sebou, hodnoty nejsou oddělené mezerou. Pokud chcete WriteValue vložit prázdné místo, musíte volat WriteWhitespace mezi hovory. Předejte typ pole přetížení XmlWriter.WriteValue(Object) , aby bylo možné zapsat pole jedinečných hodnot.

Pokud se tato metoda volá u XmlWriter instance, která vypíše pouze text, typová hodnota se serializuje na text.

Pro asynchronní operace převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(Object)

Zapíše hodnotu objektu.

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)

Parametry

value: Object

Hodnota objektu pro zápis.

Poznámka Při vydání .NET Framework 3.5 tato metoda přijímá DateTimeOffset jako parametr.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

ArgumentNullException

To value je null.

InvalidOperationException

Zapisovač je zavřený nebo je v chybovém stavu.

-nebo-

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Poznámky

Tato metoda přebírá objekt CLR (Common Language Runtime) a převede vstupní hodnotu na požadovaný výstupní typ pomocí pravidel převodu datových typů XSD (XML Schema Definition Language).

Pokud je objekt CLR typem seznamu, například IEnumerable, IListnebo ICollection, je považován za pole typu hodnoty. Převede XmlWriter hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(Int64)

Int64 Zapíše hodnotu.

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)

Parametry

value: Int64

Hodnota Int64 k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Poznámky

Tato metoda přebírá objekt common language runtime a převede vstupní hodnotu na požadovaný typ výstupu pomocí pravidel převodu datových typů jazyka XSD (XML Schema Definition Language).

WriteValue Při zavolání XmlWriter metody převede hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud WriteValue je volána vícekrát za sebou, hodnoty nejsou odděleny mezerou. Pokud chcete WriteValue vložit prázdné znaky, musíte volat WriteWhitespace mezi volání. Předejte typ pole přetížení XmlWriter.WriteValue(Object) , aby bylo možné zapsat pole jedinečných hodnot.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(Int32)

Int32 Zapíše hodnotu.

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)

Parametry

value: Int32

Hodnota Int32 k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Poznámky

Tato metoda přebírá objekt common language runtime a převede vstupní hodnotu na požadovaný typ výstupu pomocí pravidel převodu datových typů jazyka XSD (XML Schema Definition Language).

WriteValue Při zavolání XmlWriter metody převede hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(Double)

Double Zapíše hodnotu.

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)

Parametry

value: Double

Hodnota Double k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Příklady

Následující příklad zapíše uzel knihy pomocí zadaných dat.

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

Poznámky

Tato metoda přebírá objekt common language runtime a převede vstupní hodnotu na požadovaný typ výstupu pomocí pravidel převodu datových typů jazyka XSD (XML Schema Definition Language).

WriteValue Při zavolání XmlWriter metody převede hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(String)

Zapíše String hodnotu.

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)

Parametry

value: String

Hodnota k zápisu String .

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá zpráva "Asynchronní operace už probíhá".

Poznámky

Pokud se tato metoda volá u XmlWriter instance, která vypíše pouze text, typová hodnota se serializuje na text.

Pro asynchronní operace použijte metodu WriteStringAsync .

Platí pro

WriteValue(DateTimeOffset)

DateTimeOffset Zapíše hodnotu.

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)

Parametry

value: DateTimeOffset

Hodnota DateTimeOffset k zápisu.

Výjimky

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Poznámky

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(DateTime)

DateTime Zapíše hodnotu.

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)

Parametry

value: DateTime

Hodnota DateTime k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Příklady

Následující příklad zapíše uzel knihy pomocí zadaných dat.

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

Poznámky

Tato metoda přebírá objekt common language runtime a převede vstupní hodnotu na požadovaný typ výstupu pomocí pravidel převodu datových typů jazyka XSD (XML Schema Definition Language).

WriteValue Při zavolání XmlWriter metody převede hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(Boolean)

Boolean Zapíše hodnotu.

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)

Parametry

value: Boolean

Hodnota Boolean k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Poznámky

Tato metoda přebírá objekt common language runtime a převede vstupní hodnotu na požadovaný typ výstupu pomocí pravidel převodu datových typů jazyka XSD (XML Schema Definition Language).

WriteValue Při zavolání XmlWriter metody převede hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

WriteValue(Decimal)

Decimal Zapíše hodnotu.

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)

Parametry

value: Decimal

Hodnota Decimal k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

XmlWriter Před dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace již probíhá".

Poznámky

Tato metoda přebírá objekt common language runtime a převede vstupní hodnotu na požadovaný typ výstupu pomocí pravidel převodu datových typů jazyka XSD (XML Schema Definition Language).

WriteValue Při zavolání XmlWriter metody převede hodnotu na řetězcové reprezentace podle pravidel datového typu schématu XML (XSD) a zapíše ji pomocí WriteString metody.

Pokud je tato metoda volána u XmlWriter instance, která je výstupem pouze text, zadaná hodnota je serializována na text.

V případě asynchronních operací převeďte návratovou hodnotu této metody na řetězec a použijte metodu WriteStringAsync .

Platí pro

XmlWriter.WriteValue Metoda

Definice

Přetížení

Poznámky

WriteValue(Single)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(Object)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(Int64)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(Int32)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(Double)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

WriteValue(String)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(DateTimeOffset)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(DateTime)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

WriteValue(Boolean)

Parametry

Výjimky

Poznámky

Platí pro

WriteValue(Decimal)

Parametry

Výjimky

Poznámky

Platí pro

Další materiály