Sdílet prostřednictvím


XmlWriter.WriteValue Metoda

Definice

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

Byla zadána neplatná hodnota.

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

Byla zadána neplatná hodnota.

To value je null.

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

Byla zadána neplatná hodnota.

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

Byla zadána neplatná hodnota.

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(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

Byla zadána neplatná hodnota.

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 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(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

Byla zadána neplatná hodnota.

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).

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 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

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

Byla zadána neplatná hodnota.

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 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(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

Byla zadána neplatná hodnota.

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(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

Byla zadána neplatná hodnota.

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