XmlConvert Класс

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlConvert.cs

Кодирует и декодирует XML-имена и предоставляет методы для преобразования между типами среды CLR и типами языка определения схемы XML (XSD). При преобразовании типов данных возвращаемые значения не зависят от языкового стандарта.

public ref class XmlConvert

public class XmlConvert

type XmlConvert = class

Public Class XmlConvert

Наследование

Object

XmlConvert

Комментарии

Класс XmlConvert функционально эквивалентен классу Convert , но поддерживает XML-стандарты. Система типов основана на языке определения схем XML (XSD), а возвращаемые значения всегда являются независимыми от региональных настроек.

Кодировка и декодирование

Имена элементов и атрибутов или значения идентификаторов ограничены диапазоном XML-символов в соответствии с рекомендацией W3C XML 1.0. Если имена содержат недопустимые символы, можно использовать EncodeNameDecodeName методы в этом классе, чтобы перевести их в допустимые XML-имена.

Например, если вы хотите использовать заголовок столбца "Детали заказа" в базе данных, база данных допускает пробел между двумя словами. Однако в XML пространство между "Order" и "Detail" считается недопустимым XML-символом. Его необходимо преобразовать в шестнадцатеричное кодирование и декодировать его позже.

Метод можно использовать с классом EncodeNameXmlWriter , чтобы убедиться, что имена, записанные, являются допустимыми XML-именами. Следующий код C# преобразует имя Order Detail в допустимое XML-имя и записывает элемент <Order_0x0020_Detail>My order</Order_0x0020_Detail>.

writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");

XmlConvert Следующие методы выполняют кодировку и декодирование.

Метод	Description
EncodeName	Принимает имя и возвращает закодированное имя вместе с любым недопустимым символом, заменяемым escape-строкой. Этот метод позволяет, чтобы двоеточия могли находиться в любой позиции, что означает, что имя по-прежнему может быть недопустимым в соответствии с рекомендацией W3C Namespaces в XML 1.0.
EncodeNmToken	Принимает имя и возвращает закодированное имя.
EncodeLocalName	EncodeName То же самое, за исключением того, что он также кодирует символ двоеточия, гарантируя, что имя может быть использовано в качестве LocalName части имени пространства имен.
DecodeName	Отменяет преобразование для всех методов кодирования.

Проверка имени

Класс XmlConvert содержит два метода, которые проверяют символы в имени элемента или атрибута и проверяют соответствие имени правилам, заданным рекомендацией W3C XML 1.0:

• VerifyName проверяет символы и проверяет, является ли имя допустимым. Метод возвращает имя, если оно допустимо, и вызывает исключение, если это не так.
• VerifyNCName выполняет ту же проверку, но принимает неквалифицированные имена.

Он XmlConvert содержит дополнительные методы, которые проверяют маркеры, символы пробелов, общедоступные идентификаторы и другие строки.

Преобразование типов данных

XmlConvert также предоставляет методы, позволяющие преобразовать данные из строки в строго типизированный тип данных. Например, ToDateTime метод преобразует строку в его DateTime эквивалент. Это полезно, так как большинство методов в XmlReader классе возвращают данные в виде строки. После чтения данных его можно преобразовать в правильный тип данных перед использованием. Перегрузки ToString обеспечивают дополнительную операцию путем преобразования строго типизированных данных в строки. Например, это полезно при добавлении данных в текстовые поля на веб-странице. Параметры локальных настроек не учитываются во время преобразования данных. Типы данных основаны на типах данных СХЕМЫ XML (XSD).

Конструкторы

Имя	Описание
XmlConvert()	Инициализирует новый экземпляр класса XmlConvert.

Методы

Имя	Описание
DecodeName(String)	Декодирует имя. Этот метод выполняет обратное значение EncodeName(String) и EncodeLocalName(String) методы.
EncodeLocalName(String)	Преобразует имя в допустимое локальное имя XML.
EncodeName(String)	Преобразует имя в допустимое XML-имя.
EncodeNmToken(String)	Проверяет допустимое имя в соответствии со спецификацией XML.
IsNCNameChar(Char)	Проверяет, является ли переданный символ допустимым типом символа без двоеточия.
IsPublicIdChar(Char)	Возвращает переданный экземпляр символа, если символ в аргументе является допустимым символом общедоступного идентификатора, в противном случае null.
IsStartNCNameChar(Char)	Проверяет, является ли переданный символ допустимым типом символа начального имени.
IsWhitespaceChar(Char)	Проверяет, является ли переданный символ допустимым символом пробела XML.
IsXmlChar(Char)	Проверяет, является ли переданный символ допустимым XML-символом.
IsXmlSurrogatePair(Char, Char)	Проверяет, является ли переданная суррогатная пара символов допустимым XML-символом.
ToBoolean(String)	Преобразует его в StringBoolean эквивалент.
ToByte(String)	Преобразует его в StringByte эквивалент.
ToChar(String)	Преобразует его в StringChar эквивалент.
ToDateTime(String, String)	Преобразует его в StringDateTime эквивалент.
ToDateTime(String, String[])	Преобразует его в StringDateTime эквивалент.
ToDateTime(String, XmlDateTimeSerializationMode)	Преобразует его String в DateTime указанное XmlDateTimeSerializationMode значение.
ToDateTime(String)	Устаревшие. Преобразует его в StringDateTime эквивалент.
ToDateTimeOffset(String, String)	Преобразует предоставленный StringDateTimeOffset в эквивалент.
ToDateTimeOffset(String, String[])	Преобразует предоставленный StringDateTimeOffset в эквивалент.
ToDateTimeOffset(String)	Преобразует предоставленный StringDateTimeOffset в эквивалент.
ToDecimal(String)	Преобразует его в StringDecimal эквивалент.
ToDouble(String)	Преобразует его в StringDouble эквивалент.
ToGuid(String)	Преобразует его в StringGuid эквивалент.
ToInt16(String)	Преобразует его в StringInt16 эквивалент.
ToInt32(String)	Преобразует его в StringInt32 эквивалент.
ToInt64(String)	Преобразует его в StringInt64 эквивалент.
ToSByte(String)	Преобразует его в StringSByte эквивалент.
ToSingle(String)	Преобразует его в StringSingle эквивалент.
ToString(Boolean)	Преобразует объект BooleanStringв .
ToString(Byte)	Преобразует объект ByteStringв .
ToString(Char)	Преобразует объект CharStringв .
ToString(DateTime, String)	Преобразует объект DateTimeStringв .
ToString(DateTime, XmlDateTimeSerializationMode)	Преобразует его DateTime в String указанное XmlDateTimeSerializationMode значение.
ToString(DateTime)	Устаревшие. Преобразует объект DateTimeStringв .
ToString(DateTimeOffset, String)	Преобразует предоставленный DateTimeOffset в указанный String формат.
ToString(DateTimeOffset)	Преобразует предоставленный DateTimeOffsetStringобъект в .
ToString(Decimal)	Преобразует объект DecimalStringв .
ToString(Double)	Преобразует объект DoubleStringв .
ToString(Guid)	Преобразует объект GuidStringв .
ToString(Int16)	Преобразует объект Int16Stringв .
ToString(Int32)	Преобразует объект Int32Stringв .
ToString(Int64)	Преобразует объект Int64Stringв .
ToString(SByte)	Преобразует объект SByteStringв .
ToString(Single)	Преобразует объект SingleStringв .
ToString(TimeSpan)	Преобразует объект TimeSpanStringв .
ToString(UInt16)	Преобразует объект UInt16Stringв .
ToString(UInt32)	Преобразует объект UInt32Stringв .
ToString(UInt64)	Преобразует объект UInt64Stringв .
ToTimeSpan(String)	Преобразует его в StringTimeSpan эквивалент.
ToUInt16(String)	Преобразует его в StringUInt16 эквивалент.
ToUInt32(String)	Преобразует его в StringUInt32 эквивалент.
ToUInt64(String)	Преобразует его в StringUInt64 эквивалент.
VerifyName(String)	Проверяет, является ли имя допустимым в соответствии с рекомендацией по языку расширенной разметки W3C.
VerifyNCName(String)	Проверяет, является ли имя допустимым NCName в соответствии с рекомендацией по языку расширенной разметки W3C. Имя NCName , которое не может содержать двоеточие.
VerifyNMTOKEN(String)	Проверяет, является ли строка допустимой NMTOKEN в соответствии с рекомендациями по схеме XML W3C, часть 2.
VerifyPublicId(String)	Возвращает переданный в строковом экземпляре, если все символы в строковом аргументе являются допустимыми символами открытого идентификатора.
VerifyTOKEN(String)	Проверяет, является ли строка допустимым маркером в соответствии с рекомендациями по схеме XML W3C, часть 2.
VerifyWhitespace(String)	Возвращает переданный экземпляр строки, если все символы в строковом аргументе являются допустимыми символами пробелов.
VerifyXmlChars(String)	Возвращает переданную строку, если все символы и суррогатные символы пары в аргументе строки являются допустимыми XML-символами, в противном случае XmlException создается информация о первом недопустимом символе.