XmlWriter.WriteValue Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Menulis satu nilai yang ditik sederhana.

Overload

Nama	Deskripsi
WriteValue(Single)	Menulis angka floating-point presisi tunggal.
WriteValue(Object)	Menulis nilai objek.
WriteValue(Int64)	Int64 Menulis nilai.
WriteValue(Int32)	Int32 Menulis nilai.
WriteValue(Double)	Double Menulis nilai.
WriteValue(String)	String Menulis nilai.
WriteValue(DateTimeOffset)	DateTimeOffset Menulis nilai.
WriteValue(DateTime)	DateTime Menulis nilai.
WriteValue(Boolean)	Boolean Menulis nilai.
WriteValue(Decimal)	Decimal Menulis nilai.

Keterangan

Metode ini WriteValue menerima nilai yang diketik sederhana runtime bahasa umum (CLR), mengonversinya ke representasi string mereka sesuai dengan aturan konversi jenis data bahasa definisi skema XML (XSD), dan menulisnya dengan menggunakan metode .WriteString Ini memungkinkan Anda untuk menyalurkan nilai jenis sederhana dengan overhead pemisahan ulang minimal saat meneruskan data antara XPathDocument, XmlReader, dan XmlWriter objek. Kemampuan ini juga berguna saat berhadapan dengan jenis sederhana CLR dan XmlWriter instans. Anda dapat memanggil WriteValue metode untuk menulis nilai yang ditik alih-alih menggunakan metode di XmlConvert kelas untuk mengonversi data yang diekstrak menjadi nilai string sebelum menulisnya.

Untuk operasi asinkron, konversikan nilai WriteValue pengembalian menjadi string dan gunakan WriteStringAsync metode .

Tabel berikut ini memperlihatkan jenis data XSD default yang sesuai dengan jenis CLR.

Jika objek CLR adalah jenis daftar, seperti IEnumerable, , IListatau ICollection, objek diperlakukan sebagai array dari jenis nilai.

jenis CLR	Jenis data XSD default
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte Array	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd:desimal
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

**Jenis ini tidak sesuai dengan CLS. Mereka tidak memiliki metode yang WriteValue sesuai.

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong.

WriteValue(Single)

Sumber:

XmlWriter.cs

Menulis angka floating-point presisi tunggal.

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)

Parameter

value

Single

Angka floating-point presisi tunggal untuk ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(Object)

Sumber:

XmlWriter.cs

Menulis nilai objek.

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)

Parameter

value

Object

Nilai objek yang akan ditulis.

Note Dengan rilis .NET Framework 3.5, metode ini menerima DateTimeOffset sebagai parameter.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

ArgumentNullException

value adalah null.

InvalidOperationException

Penulis ditutup atau dalam status kesalahan.

-atau-

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum (CLR) dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Jika objek CLR adalah jenis daftar seperti IEnumerable, , IListatau ICollection, objek diperlakukan sebagai array dari jenis nilai. mengonversi XmlWriter nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(Int64)

Sumber:

XmlWriter.cs

Int64 Menulis nilai.

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)

Parameter

value

Int64

Nilai Int64 yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(Int32)

Sumber:

XmlWriter.cs

Int32 Menulis nilai.

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)

Parameter

value

Int32

Nilai Int32 yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(Double)

Sumber:

XmlWriter.cs

Double Menulis nilai.

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)

Parameter

value

Double

Nilai Double yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Contoh

Contoh berikut menulis simpul buku menggunakan data yang ditik.

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

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(String)

Sumber:

XmlWriter.cs

String Menulis nilai.

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)

Parameter

value

String

Nilai String yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, gunakan WriteStringAsync metode .

WriteValue(DateTimeOffset)

Sumber:

XmlWriter.cs

DateTimeOffset Menulis nilai.

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)

Parameter

value

DateTimeOffset

Nilai DateTimeOffset yang akan ditulis.

Pengecualian

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(DateTime)

Sumber:

XmlWriter.cs

DateTime Menulis nilai.

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)

Parameter

value

DateTime

Nilai DateTime yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Contoh

Contoh berikut menulis simpul buku menggunakan data yang ditik.

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

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(Boolean)

Sumber:

XmlWriter.cs

Boolean Menulis nilai.

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)

Parameter

value

Boolean

Nilai Boolean yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .

WriteValue(Decimal)

Sumber:

XmlWriter.cs

Decimal Menulis nilai.

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)

Parameter

value

Decimal

Nilai Decimal yang akan ditulis.

Pengecualian

ArgumentException

Nilai yang tidak valid ditentukan.

InvalidOperationException

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini mengambil objek runtime bahasa umum dan mengonversi nilai input ke jenis output yang diinginkan menggunakan aturan konversi jenis data bahasa definisi Skema XML (XSD).

Ketika metode dipanggil WriteValue , XmlWriter mengonversi nilai ke representasi stringnya sesuai dengan aturan jenis data Skema XML (XSD) dan menulisnya menggunakan WriteString metode .

Jika WriteValue dipanggil beberapa kali berturut-turut, nilai tidak dibatasi oleh spasi. Anda harus memanggil WriteWhitespace antar panggilan untuk WriteValue menyisipkan spasi kosong. Teruskan jenis array ke XmlWriter.WriteValue(Object) kelebihan beban untuk menulis array nilai yang berbeda.

Jika metode ini dipanggil pada XmlWriter instans yang menghasilkan teks saja, nilai yang diserialisasikan ke teks.

Untuk operasi asinkron, konversikan nilai pengembalian metode ini menjadi string dan gunakan WriteStringAsync metode .