XmlConvert Sınıf

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlConvert.cs

XML adlarını kodlar ve çözer ve ortak dil çalışma zamanı türleri ile XML Şema tanım dili (XSD) türleri arasında dönüştürme yöntemleri sağlar. Veri türleri dönüştürülürken, döndürülen değerler yerel ayardan bağımsızdır.

public ref class XmlConvert

public class XmlConvert

type XmlConvert = class

Public Class XmlConvert

Devralma

Object

XmlConvert

Açıklamalar

XmlConvert sınıfı işlevsel olarak sınıfına Convert eşdeğerdir, ancak XML standartlarını destekler. Tür sistemi XML Şema tanım dili (XSD) şema türünü temel alır ve döndürülen değerler her zaman yerel ayardan bağımsızdır.

Kodlama ve kod çözme

Öğe ve öznitelik adları veya kimlik değerleri, W3C XML 1.0 önerisine göre bir XML karakter aralığıyla sınırlıdır. Adlar geçersiz karakterler içerdiğinde, bunları geçerli XML adlarına çevirmek için bu sınıftaki ve EncodeName yöntemlerini kullanabilirsinizDecodeName.

Örneğin, bir veritabanında "Sipariş Ayrıntısı" sütun başlığını kullanmak istiyorsanız, veritabanı iki sözcük arasındaki boşluğa izin verir. Ancak, XML'de "Order" ve "Detail" arasındaki boşluk geçersiz bir XML karakteri olarak kabul edilir. Bunu escape edilmiş onaltılık kodlamaya dönüştürmeniz ve daha sonra kodunu çözmeniz gerekir.

EncodeName yöntemini XmlWriter sınıfıyla kullanarak yazılan adların geçerli XML adları olduğundan emin olabilirsiniz. Aşağıdaki C# kodu ,"Sipariş Ayrıntısı" adını geçerli bir XML adına dönüştürür ve öğesini <Order_0x0020_Detail>My order</Order_0x0020_Detail>yazar.

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

Aşağıdaki XmlConvert yöntemler kodlama ve kod çözme gerçekleştirir.

Method	Description
EncodeName	Bir ad alır ve geçersiz karakterlerin kaçış dizesiyle değiştirildiği kodlanmış adı geri döndürür. Bu yöntem, herhangi bir konumda iki nokta üst üste işaretine izin verir; bu da, adın W3C XML 1.0'daki Ad Alanları önerisine göre hala geçersiz olabileceği anlamına gelir.
EncodeNmToken	Bir ad alır ve kodlanmış adı döndürür.
EncodeLocalName	EncodeName karakterine ek olarak iki nokta üst üste karakterini de kodlamak suretiyle bu adın, ad alanı nitelikli bir adın LocalName bölümü olarak kullanılabilirliğini garanti eder.
DecodeName	Tüm kodlama yöntemleri için dönüştürmeyi tersine çevirir.

Ad doğrulama

sınıfı, XmlConvert bir öğe veya öznitelik adındaki karakterleri denetleyerek adın W3C XML 1.0 önerisi tarafından ayarlanan kurallara uygun olduğunu doğrulayan iki yöntem içerir:

• VerifyName karakterleri denetler ve adın geçerli olduğunu doğrular. Bu Yöntem geçerliyse adı döndürür ve değilse bir hata fırlatır.
• VerifyNCName aynı doğrulamayı gerçekleştirir, ancak nitelenmemiş adları kabul eder.

XmlConvert belirteçleri, boşluk karakterlerini, genel kimlikleri ve diğer dizeleri doğrulayan ek yöntemler içerir.

Veri türü dönüştürme

XmlConvert ayrıca, bir dizeden kesin olarak türü belirlenmiş bir veri türüne veri dönüştürmenizi sağlayan yöntemler sağlar. Örneğin, ToDateTime yöntemi bir dizeyi eşdeğerine DateTime dönüştürür. Sınıftaki yöntemlerin XmlReader çoğu verileri dize olarak döndüreceği için bu kullanışlıdır. Veriler okunduktan sonra kullanılmadan önce uygun veri türüne dönüştürülebilir. Aşırı ToString yüklemeler, kesin olarak yazılan verileri dizelere dönüştürerek tamamlayıcı işlemi sağlar. Örneğin, bir web sayfasındaki metin kutularına veri eklemek istediğinizde bu yararlı olabilir. Veri dönüştürme sırasında yerel ayar ayarları dikkate alınmaz. Veri türleri XML Şeması (XSD) veri türlerini temel alır.

Oluşturucular

Name	Description
XmlConvert()	XmlConvert sınıfının yeni bir örneğini başlatır.

Yöntemler

Name	Description
DecodeName(String)	Bir adın kodunu çözer. Bu yöntem ve EncodeName(String) yöntemlerinin tersini EncodeLocalName(String) yapar.
EncodeLocalName(String)	Adı geçerli bir XML yerel adına dönüştürür.
EncodeName(String)	Adı geçerli bir XML adına dönüştürür.
EncodeNmToken(String)	Adın XML belirtimine göre geçerli olduğunu doğrular.
IsNCNameChar(Char)	Geçirilen karakterin geçerli bir iki nokta olmayan karakter türü olup olmadığını denetler.
IsPublicIdChar(Char)	Bağımsız değişkendeki karakter geçerli bir ortak kimlik karakteriyse geçirilen karakter örneğini döndürür, aksi takdirde null.
IsStartNCNameChar(Char)	Geçirilen karakterin geçerli bir Başlangıç Adı Karakter türü olup olmadığını denetler.
IsWhitespaceChar(Char)	Geçirilen karakterin geçerli bir XML boşluk karakteri olup olmadığını denetler.
IsXmlChar(Char)	Geçirilen karakterin geçerli bir XML karakteri olup olmadığını denetler.
IsXmlSurrogatePair(Char, Char)	Geçirilen vekil karakter çiftinin geçerli bir XML karakteri olup olmadığını denetler.
ToBoolean(String)	öğesini String eşdeğere Boolean dönüştürür.
ToByte(String)	öğesini String eşdeğere Byte dönüştürür.
ToChar(String)	öğesini String eşdeğere Char dönüştürür.
ToDateTime(String, String)	öğesini String eşdeğere DateTime dönüştürür.
ToDateTime(String, String[])	öğesini String eşdeğere DateTime dönüştürür.
ToDateTime(String, XmlDateTimeSerializationMode)	String öğesini belirtilen öğesini kullanarak DateTime öğesine XmlDateTimeSerializationMode dönüştürür.
ToDateTime(String)	Geçersiz. öğesini String eşdeğere DateTime dönüştürür.
ToDateTimeOffset(String, String)	Sağlanan String öğesini eşdeğere DateTimeOffset dönüştürür.
ToDateTimeOffset(String, String[])	Sağlanan String öğesini eşdeğere DateTimeOffset dönüştürür.
ToDateTimeOffset(String)	Sağlanan String öğesini eşdeğere DateTimeOffset dönüştürür.
ToDecimal(String)	öğesini String eşdeğere Decimal dönüştürür.
ToDouble(String)	öğesini String eşdeğere Double dönüştürür.
ToGuid(String)	öğesini String eşdeğere Guid dönüştürür.
ToInt16(String)	öğesini String eşdeğere Int16 dönüştürür.
ToInt32(String)	öğesini String eşdeğere Int32 dönüştürür.
ToInt64(String)	öğesini String eşdeğere Int64 dönüştürür.
ToSByte(String)	öğesini String eşdeğere SByte dönüştürür.
ToSingle(String)	öğesini String eşdeğere Single dönüştürür.
ToString(Boolean)	öğesini Boolean öğesine Stringdönüştürür.
ToString(Byte)	öğesini Byte öğesine Stringdönüştürür.
ToString(Char)	öğesini Char öğesine Stringdönüştürür.
ToString(DateTime, String)	öğesini DateTime öğesine Stringdönüştürür.
ToString(DateTime, XmlDateTimeSerializationMode)	DateTime öğesini belirtilen öğesini kullanarak String öğesine XmlDateTimeSerializationMode dönüştürür.
ToString(DateTime)	Geçersiz. öğesini DateTime öğesine Stringdönüştürür.
ToString(DateTimeOffset, String)	Sağlanan DateTimeOffset öğesini belirtilen biçimde değerine String dönüştürür.
ToString(DateTimeOffset)	Sağlanan DateTimeOffset öğesini bir Stringöğesine dönüştürür.
ToString(Decimal)	öğesini Decimal öğesine Stringdönüştürür.
ToString(Double)	öğesini Double öğesine Stringdönüştürür.
ToString(Guid)	öğesini Guid öğesine Stringdönüştürür.
ToString(Int16)	öğesini Int16 öğesine Stringdönüştürür.
ToString(Int32)	öğesini Int32 öğesine Stringdönüştürür.
ToString(Int64)	öğesini Int64 öğesine Stringdönüştürür.
ToString(SByte)	öğesini SByte öğesine Stringdönüştürür.
ToString(Single)	öğesini Single öğesine Stringdönüştürür.
ToString(TimeSpan)	öğesini TimeSpan öğesine Stringdönüştürür.
ToString(UInt16)	öğesini UInt16 öğesine Stringdönüştürür.
ToString(UInt32)	öğesini UInt32 öğesine Stringdönüştürür.
ToString(UInt64)	öğesini UInt64 öğesine Stringdönüştürür.
ToTimeSpan(String)	öğesini String eşdeğere TimeSpan dönüştürür.
ToUInt16(String)	öğesini String eşdeğere UInt16 dönüştürür.
ToUInt32(String)	öğesini String eşdeğere UInt32 dönüştürür.
ToUInt64(String)	öğesini String eşdeğere UInt64 dönüştürür.
VerifyName(String)	W3C Genişletilmiş biçimlendirme dili önerisine göre adın geçerli bir ad olduğunu doğrular.
VerifyNCName(String)	W3C Genişletilmiş biçimlendirme dili önerisine göre adın geçerli NCName olduğunu doğrular. , NCName iki nokta üst üste içeremeyen bir addır.
VerifyNMTOKEN(String)	W3C XML Şeması Bölüm2: Veri Türleri önerisine göre dizenin geçerli bir NMTOKEN olduğunu doğrular.
VerifyPublicId(String)	Dize bağımsız değişkenindeki tüm karakterler geçerli ortak kimlik karakterleriyse, geçirilen dize örneğini döndürür.
VerifyTOKEN(String)	W3C XML Şeması Bölüm2: Veri türleri önerisine göre dizenin geçerli bir belirteç olduğunu doğrular.
VerifyWhitespace(String)	Dize bağımsız değişkenindeki tüm karakterler geçerli boşluk karakterleriyse, geçirilen dize örneğini döndürür.
VerifyXmlChars(String)	Dize bağımsız değişkenindeki tüm karakterler ve vekil çift karakterleri geçerli XML karakterleriyse, geçirilen dizeyi döndürür; aksi takdirde, karşılaşılan ilk geçersiz karakterle ilgili bilgilerle bir XmlException oluşturulur.