XmlWriter.WriteValue Метод

Определение

Пространство имен:: System.Xml

Сборки:: System.Xml.dll, System.Xml.ReaderWriter.dll

Сборки:: netstandard.dll, System.Xml.ReaderWriter.dll

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает одно простое типизированное значение.

Перегрузки

Имя	Описание
WriteValue(Single)	Записывает число с плавающей запятой с одной точностью.
WriteValue(Object)	Записывает значение объекта.
WriteValue(Int64)	Записывает Int64 значение.
WriteValue(Int32)	Записывает Int32 значение.
WriteValue(Double)	Записывает Double значение.
WriteValue(String)	Записывает String значение.
WriteValue(DateTimeOffset)	Записывает DateTimeOffset значение.
WriteValue(DateTime)	Записывает DateTime значение.
WriteValue(Boolean)	Записывает Boolean значение.
WriteValue(Decimal)	Записывает Decimal значение.

Метод WriteValue принимает простые типизированные значения среды CLR, преобразует их в строковые представления в соответствии с правилами преобразования типов данных языка определения XML-схемы (XSD) и записывает их с помощью WriteString метода. Это позволяет конвейерировать простые значения с минимальными затратами на повторную обработку при передаче данных между XPathDocumentобъектами XmlReaderи XmlWriter объектами. Эта возможность также полезна при работе с простыми типами СРЕДЫ CLR и экземпляром XmlWriter . Метод можно вызвать WriteValue для записи типизированного значения вместо использования методов в классе для преобразования типизированных данных в XmlConvert строковое значение перед его записью.

Для асинхронных операций преобразуйте возвращаемое значение WriteValue в строку и используйте WriteStringAsync метод.

В следующей таблице показаны типы данных XSD по умолчанию, соответствующие типам CLR.

Если объект CLR является типом списка, например IEnumerable, IListили ICollection, он рассматривается как массив типа значения.

Тип CLR	Тип данных XSD по умолчанию
System.Boolean	xsd:boolean
System.Byte**	xsd:integer
массив System.Byte	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

**Эти типы не соответствуют CLS. У них нет соответствующих WriteValue методов.

WriteValue(Single)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает число с плавающей запятой с одной точностью.

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)

Параметры

value: Single

Число с плавающей запятой с плавающей точностью для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Метод XmlWriter был вызван до завершения предыдущей асинхронной операции. В этом случае InvalidOperationException создается сообщение "Асинхронная операция уже выполняется".

Этот метод принимает объект среды CLR и преобразует входное значение в нужный выходной тип с помощью правил преобразования типов данных языка определения схемы XML (XSD).

WriteValue При вызове XmlWriter метода значение преобразуется в его строковые представления в соответствии с правилами типа данных СХЕМЫ XML (XSD) и записывает его с помощью WriteString метода.

Если WriteValue вызывается несколько раз в последовательности, значения не разделяются пробелом. Необходимо вызвать вызов WriteWhitespace между вызовами для WriteValue вставки пробелов. Передайте тип массива перегрузке XmlWriter.WriteValue(Object) для записи массива различных значений.

Если этот метод вызывается в экземпляре XmlWriter , который выводит только текст, типизированное значение сериализуется в текст.

Для асинхронных операций преобразуйте возвращаемое значение этого метода в строку и используйте WriteStringAsync метод.

Применяется к

WriteValue(Object)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает значение объекта.

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)

Параметры

value: Object

Значение объекта для записи.

Note С выпуском .NET Framework 3.5 этот метод принимает DateTimeOffset в качестве параметра.

Исключения

ArgumentException

Указано недопустимое значение.

ArgumentNullException

Значение value равно null.

InvalidOperationException

Модуль записи закрыт или находится в состоянии ошибки.

–или–

Этот метод принимает объект среды CLR и преобразует входное значение в нужный выходной тип с помощью правил преобразования типов данных языка определения XML-схемы (XSD).

Если объект CLR является типом списка, например IEnumerable, IListили ICollection, он рассматривается как массив типа значения. Значение XmlWriter преобразуется в его строковые представления в соответствии с правилами типа данных СХЕМЫ XML (XSD) и записывает его с помощью WriteString метода.

Применяется к

WriteValue(Int64)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает Int64 значение.

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)

Параметры

value: Int64

Значение Int64 для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Применяется к

WriteValue(Int32)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает Int32 значение.

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)

Параметры

value: Int32

Значение Int32 для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Применяется к

WriteValue(Double)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает Double значение.

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)

Параметры

value: Double

Значение Double для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Примеры

В следующем примере записывается узел книги с помощью типизированных данных.

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

Применяется к

WriteValue(String)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает String значение.

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)

Параметры

value: String

Значение String для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Применяется к

WriteValue(DateTimeOffset)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает DateTimeOffset значение.

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)

Параметры

value: DateTimeOffset

Значение DateTimeOffset для записи.

Исключения

InvalidOperationException

Применяется к

WriteValue(DateTime)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает DateTime значение.

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)

Параметры

value: DateTime

Значение DateTime для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Примеры

В следующем примере записывается узел книги с помощью типизированных данных.

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

Применяется к

WriteValue(Boolean)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает Boolean значение.

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)

Параметры

value: Boolean

Значение Boolean для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Применяется к

WriteValue(Decimal)

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Исходный код:: XmlWriter.cs

Записывает Decimal значение.

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)

Параметры

value: Decimal

Значение Decimal для записи.

Исключения

ArgumentException

Указано недопустимое значение.

InvalidOperationException

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

XmlWriter.WriteValue Метод

Определение

Перегрузки

Комментарии

WriteValue(Single)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(Object)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(Int64)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(Int32)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(Double)

Параметры

Исключения

Примеры

Комментарии

Применяется к

WriteValue(String)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(DateTimeOffset)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(DateTime)

Параметры

Исключения

Примеры

Комментарии

Применяется к

WriteValue(Boolean)

Параметры

Исключения

Комментарии

Применяется к

WriteValue(Decimal)

Параметры

Исключения

Комментарии

Применяется к

Обратная связь