XmlWriter.WriteValue Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zapíše jednu jednoduchou hodnotu.

Přetížení

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

Poznámky

Metoda WriteValue přijímá jednoduché hodnoty modulu CLR (Common Language Runtime), převádí je na řetězcové reprezentace podle pravidel převodu datových typů jazyka XSD (XML Schema Definition Language) a zapisuje je pomocí WriteString 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 WriteValue můžete volat tak, aby zapisovala zadaná hodnota namísto použití metod ve XmlConvert třídě k převodu zadaných dat na řetězcovou hodnotu předtím, než ji napíšete.

Pro asynchronní operace převeďte návratovou WriteValue hodnotu 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 typ 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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání.

WriteValue(Single)

Zdroj:

XmlWriter.cs

Zapíše jednopřesné číslo s plovoucí desetinnou čá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

Číslo s plovoucí desetinnou čárkou s jednoduchou přesností pro zápis.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

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

Poznámky

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

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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

WriteValue(Object)

Zdroj:

XmlWriter.cs

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 k zápisu.

Note S vydáním .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

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

Poznámky

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

Pokud je objekt CLR typ 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á výstup pouze text, typová hodnota je serializována na text.

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

WriteValue(Int64)

Zdroj:

XmlWriter.cs

Zapíše Int64 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

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

Poznámky

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

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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

WriteValue(Int32)

Zdroj:

XmlWriter.cs

Zapíše Int32 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

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

Poznámky

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

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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

WriteValue(Double)

Zdroj:

XmlWriter.cs

Zapíše Double 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

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už 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 vezme objekt modulu CLR (Common Language Runtime) a převede vstupní hodnotu na požadovaný výstupní typ pomocí pravidel převodu datových typů jazyka XML Schema Definition Language (XSD).

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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

WriteValue(String)

Zdroj:

XmlWriter.cs

Zapíše String hodnotu.

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)

Parametry

value

String

Hodnota String k zápisu.

Výjimky

ArgumentException

Byla zadána neplatná hodnota.

InvalidOperationException

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

Poznámky

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

Pokud WriteValue je volána vícekrát po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

Pro asynchronní operace použijte metodu WriteStringAsync .

WriteValue(DateTimeOffset)

Zdroj:

XmlWriter.cs

Zapíše DateTimeOffset 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

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

Poznámky

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

WriteValue(DateTime)

Zdroj:

XmlWriter.cs

Zapíše DateTime 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

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už 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 vezme objekt modulu CLR (Common Language Runtime) a převede vstupní hodnotu na požadovaný výstupní typ pomocí pravidel převodu datových typů jazyka XML Schema Definition Language (XSD).

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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

WriteValue(Boolean)

Zdroj:

XmlWriter.cs

Zapíše Boolean 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

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

Poznámky

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

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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

WriteValue(Decimal)

Zdroj:

XmlWriter.cs

Zapíše Decimal 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

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

Poznámky

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

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 po sobě, hodnoty nejsou odděleny mezerou. Pokud chcete WriteWhitespace vložit prázdné znaky, musíte volat WriteValue mezi volání. Předáním typu pole přetížení zapíšete XmlWriter.WriteValue(Object) pole jedinečných hodnot.

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

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