Aracılığıyla paylaş


XmlWriter.WriteValue Yöntem

Tanım

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

Geçersiz bir değer belirtildi.

Ö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

Geçersiz bir değer belirtildi.

şeklindedir value null.

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

Geçersiz bir değer belirtildi.

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

Geçersiz bir değer belirtildi.

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

Geçersiz bir değer belirtildi.

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

Geçersiz bir değer belirtildi.

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

Ö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

Geçersiz bir değer belirtildi.

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

Geçersiz bir değer belirtildi.

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

Geçersiz bir değer belirtildi.

Ö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