XmlWriter.WriteValue Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Tek bir basit türe sahip değer yazar.

Aşırı Yüklemeler

Name	Description
WriteValue(Single)	Tek duyarlıklı kayan noktalı sayı yazar.
WriteValue(Object)	Nesne değerini yazar.
WriteValue(Int64)	Bir Int64 değer yazar.
WriteValue(Int32)	Bir Int32 değer yazar.
WriteValue(Double)	Bir Double değer yazar.
WriteValue(String)	Bir String değer yazar.
WriteValue(DateTimeOffset)	Bir DateTimeOffset değer yazar.
WriteValue(DateTime)	Bir DateTime değer yazar.
WriteValue(Boolean)	Bir Boolean değer yazar.
WriteValue(Decimal)	Bir Decimal değer yazar.

Açıklamalar

WriteValue yöntemi ortak dil çalışma zamanı (CLR) basit türdeki değerleri kabul eder, XML şema tanımı dili (XSD) veri türü dönüştürme kurallarına göre bunları dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString bunları yazar. Bu, , XPathDocumentve XmlReader nesneleri arasında XmlWriterveri geçirirken en az yeniden ayrıştırma yüküyle basit tür değerleri işlem hattı oluşturmanızı sağlar. Bu özellik, CLR basit türleri ve bir XmlWriter örnekle ilgilenirken de yararlıdır. Yazılan verileri yazmadan önce dize değerine dönüştürmek için sınıfındaki WriteValue yöntemleri kullanmak yerine, yazılan değeri yazmak için yöntemini çağırabilirsinizXmlConvert.

Zaman uyumsuz işlemler için değerinin dönüş değerini WriteValue bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

Aşağıdaki tabloda CLR türlerine karşılık gelen varsayılan XSD veri türleri gösterilmektedir.

CLR nesnesi , IEnumerableveya IListgibi ICollectionbir liste türüyse, değer türünün dizisi olarak değerlendirilir.

CLR türü	Varsayılan XSD veri türü
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
System.Byte dizi	xsd:base64Binary
System.Char**	xsd:string
System.DateTime	xsd:dateTime
System.Decimal	xsd ondalık sayı
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

**Bu türler CLS uyumlu değildir. Bunlara karşılık gelen WriteValue yöntemler yoktur.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir.

WriteValue(Single)

Kaynak:

XmlWriter.cs

Tek duyarlıklı kayan noktalı sayı yazar.

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)

Parametreler

value

Single

Yazacak tek duyarlıklı kayan nokta sayısı.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(Object)

Kaynak:

XmlWriter.cs

Nesne değerini yazar.

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)

Parametreler

value

Object

Yazacak nesne değeri.

Note .NET Framework 3.5'in yayımlanmasıyla birlikte, bu yöntem parametre olarak DateTimeOffset kabul eder.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

ArgumentNullException

value şudur: null.

InvalidOperationException

Yazıcı kapatıldı veya hata durumunda.

-veya-

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı (CLR) nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

CLR nesnesi , IEnumerableveya IListgibi ICollectionbir liste türüyse, değer türünün dizisi olarak değerlendirilir. değeri XmlWriter XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(Int64)

Kaynak:

XmlWriter.cs

Bir Int64 değer yazar.

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)

Parametreler

value

Int64

Int64 Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(Int32)

Kaynak:

XmlWriter.cs

Bir Int32 değer yazar.

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)

Parametreler

value

Int32

Int32 Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(Double)

Kaynak:

XmlWriter.cs

Bir Double değer yazar.

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)

Parametreler

value

Double

Double Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek, yazılan verileri kullanarak bir kitap düğümü yazar.

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

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(String)

Kaynak:

XmlWriter.cs

Bir String değer yazar.

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)

Parametreler

value

String

String Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için yöntemini kullanın WriteStringAsync .

WriteValue(DateTimeOffset)

Kaynak:

XmlWriter.cs

Bir DateTimeOffset değer yazar.

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)

Parametreler

value

DateTimeOffset

DateTimeOffset Yazacak değer.

Özel durumlar

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(DateTime)

Kaynak:

XmlWriter.cs

Bir DateTime değer yazar.

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)

Parametreler

value

DateTime

DateTime Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek, yazılan verileri kullanarak bir kitap düğümü yazar.

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

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(Boolean)

Kaynak:

XmlWriter.cs

Bir Boolean değer yazar.

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)

Parametreler

value

Boolean

Boolean Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .

WriteValue(Decimal)

Kaynak:

XmlWriter.cs

Bir Decimal değer yazar.

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)

Parametreler

value

Decimal

Decimal Yazacak değer.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

InvalidOperationException

Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem ortak dil çalışma zamanı nesnesini alır ve XML Şema tanım dili (XSD) veri türü dönüştürme kurallarını kullanarak giriş değerini istenen çıkış türüne dönüştürür.

WriteValue yöntemi çağrıldığında, XmlWriter değeri XML Şeması (XSD) veri türü kurallarına göre dize gösterimlerine dönüştürür ve yöntemini kullanarak WriteString yazar.

Ardı ardına birden çok kez çağrılırsa WriteValue , değerler bir boşlukla sınırlandırılmaz. Boşluk eklemek için WriteWhitespace çağrısı arasında aramanız WriteValue gerekir. Bir dizi türünü aşırı yüke XmlWriter.WriteValue(Object) geçirerek farklı değerlerden oluşan bir dizi yazın.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne göre serileştirilir.

Zaman uyumsuz işlemler için bu yöntemin dönüş değerini bir dizeye dönüştürün ve yöntemini kullanın WriteStringAsync .