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 DecodeName yöntemlerini kullanabilirsinizEncodeName.

Ö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 kaçış onaltılık kodlamaya dönüştürmeniz ve daha sonra kodunu çözmeniz gerekir.

Yazılmakta olan adların EncodeNameXmlWriter geçerli XML adları olduğundan emin olmak için sınıfıyla yöntemini kullanabilirsiniz. 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.

Metot	Açıklama
EncodeName	Bir ad alır ve kodlanmış adı, kaçış dizesiyle değiştirilen geçersiz karakterlerle birlikte döndürür. Bu yöntem herhangi bir konumda iki nokta üst üste izin verir; başka bir deyişle ad, XML 1.0'daki W3C Ad Alanları önerisine göre hala geçersiz olabilir.
EncodeNmToken	Bir ad alır ve kodlanmış adı döndürür.
EncodeLocalName	EncodeName İki nokta üst üste karakterini de kodlayarak adın ad alanı nitelenmiş bir adın parçası olarak LocalName kullanılabileceğini garanti etme dışında aynıdır.
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. yöntemi geçerliyse adı döndürür ve değilse bir özel durum oluşturur.
• 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üşümü

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.