XmlWriter.WriteValue Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Aşırı Yüklemeler

WriteValue(Single)	Tek duyarlıklı kayan noktalı bir 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üründeki 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, , XmlReaderve XmlWriter nesneleri arasında XPathDocumentveri geçirirken en az yeniden ayrıştırma yüküyle basit tür değerleri işlem hattı oluşturmanıza olanak tanır. 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 XmlConvert yöntemleri kullanmak yerine türü yazılan değeri yazmak için yöntemini çağırabilirsinizWriteValue.

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 , IListveya ICollectiongibi IEnumerablebir 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: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

**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 boşlukla sınırlandırılmaz. Boşluk eklemek için WriteValue çağrısı arasında aramanız WriteWhitespace gerekir.

WriteValue(Single)

Tek duyarlıklı kayan noktalı bir 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 boşlukla sınırlandırılmaz. Boşluk eklemek için WriteValue çağrısı arasında aramanız WriteWhitespace 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 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 .

Şunlara uygulanır

WriteValue(Object)

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.

Not .NET Framework 3.5 sürümüyle bu yöntem parametre olarak kabul ederDateTimeOffset.

Özel durumlar

ArgumentException

Geçersiz bir değer belirtildi.

ArgumentNullException

şeklindedir value null.

InvalidOperationException

Yazıcı kapalı 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 , IListveya ICollectiongibi IEnumerablebir liste türüyse, değer türünün dizisi olarak kabul edilir. 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 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 .

Şunlara uygulanır

WriteValue(Int64)

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

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.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne 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 .

Şunlara uygulanır

WriteValue(Int32)

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

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.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne 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 .

Şunlara uygulanır

WriteValue(Double)

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

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.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne 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 .

Şunlara uygulanır

WriteValue(String)

Bir String değer yazar.

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)

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 yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne serileştirilir.

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

Şunlara uygulanır

WriteValue(DateTimeOffset)

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 .

Şunlara uygulanır

WriteValue(DateTime)

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

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.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne 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 .

Şunlara uygulanır

WriteValue(Boolean)

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

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.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne 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 .

Şunlara uygulanır

WriteValue(Decimal)

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

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.

Bu yöntem yalnızca metin çıkışı veren bir XmlWriter örnekte çağrılırsa, yazılan değer metne 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 .

Şunlara uygulanır

XmlWriter.WriteValue Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

WriteValue(Single)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(Object)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(Int64)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(Int32)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(Double)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

WriteValue(String)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(DateTimeOffset)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(DateTime)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

WriteValue(Boolean)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteValue(Decimal)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar