System.Xml.XmlConvert sınıfı

Bu makale, bu API'nin başvuru belgelerine ek açıklamalar sağlar.

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.

Yöntem	Açıklama
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.