XmlValidatingReader Oluşturucular

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

XmlValidatingReader sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
XmlValidatingReader(XmlReader)	verilen XmlReaderöğesinden döndürülen içeriği doğrulayan sınıfının yeni bir örneğini XmlValidatingReader başlatır.
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)	Belirtilen değerlerle sınıfının yeni bir örneğini XmlValidatingReader başlatır.
XmlValidatingReader(String, XmlNodeType, XmlParserContext)	Belirtilen değerlerle sınıfının yeni bir örneğini XmlValidatingReader başlatır.

XmlValidatingReader(XmlReader)

Kaynak:

XmlValidatingReader.cs

verilen XmlReaderöğesinden döndürülen içeriği doğrulayan sınıfının yeni bir örneğini XmlValidatingReader başlatır.

public:
 XmlValidatingReader(System::Xml::XmlReader ^ reader);

public XmlValidatingReader(System.Xml.XmlReader reader);

new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReader

Public Sub New (reader As XmlReader)

Parametreler

reader

XmlReader

XmlReader Doğrulanırken kimden okunacak. Geçerli uygulama yalnızca XmlTextReader'yi destekler.

Özel durumlar

ArgumentException

Belirtilen okuyucu bir XmlTextReaderdeğil.

Açıklamalar

Uyarı

XmlValidatingReader.NET Framework 2.0'da sınıf kullanımdan kaldırıldı. sınıfını ve Create yöntemini kullanarak XmlReaderSettings bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Verilenden XmlReader döndürülen tüm düğümler de bu doğrulayıcı okuyucudan döndürülür, bu nedenle işlemde bilgi kaybı olmaz. Temel alınan okuyucudan döndürülmeyen yeni düğümler bu okuyucu tarafından eklenebilir (örneğin, varsayılan öznitelikler ve varlık başvurusunun alt öğeleri). Belirtilende XmlTextReader ayarlanan tüm özellikler bu doğrulayıcı okuyucu için de geçerlidir. Örneğin, sağlanan okuyucuda WhitespaceHandling.None ayarlanmışsa, bu doğrulayıcı okuyucu boşluğu da yoksayar.

Doğrulama için dış belge türü tanımları (DTD' ler) veya şemalar gerektiğinde, XmlResolver özellik dış kaynakları çözümlemek için kullanılacak nesneyi ayarlar XmlResolver .

Ayrıca bkz.

• XmlTextReader
• XmlReader

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Kaynak:

XmlValidatingReader.cs

Belirtilen değerlerle sınıfının yeni bir örneğini XmlValidatingReader başlatır.

public:
 XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader

Public Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)

Parametreler

xmlFragment

Stream

Ayrıştırmak için XML parçasını içeren akış.

fragType

XmlNodeType

XmlNodeType XML parçasının sayısı. Bu, parçanın ne içerebileceğini belirler (aşağıdaki tabloya bakın).

context

XmlParserContext

XmlParserContext XML parçasının ayrıştırılacağı yer. Bu, kullanılacak, kodlama, ad alanı kapsamı, geçerli xml:langve xml:space kapsamı içerirXmlNameTable.

Özel durumlar

XmlException

fragType aşağıdaki tabloda listelenen düğüm türlerinden biri değildir.

Açıklamalar

Uyarı

XmlValidatingReader.NET Framework 2.0'da sınıf kullanımdan kaldırıldı. sınıfını ve Create yöntemini kullanarak XmlReaderSettings bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu oluşturucu, verilen dizeyi XML parçası olarak ayrıştırıyor. XML parçası bir öğe veya öznitelikse, iyi biçimlendirilmiş XML belgeleri için kök düzey kurallarını atlayabilirsiniz.

Aşağıdaki tabloda, okuyucunun farklı düğüm türlerinin her biri için fragType geçerli değerleri ve ayrıştırma şekli listelenmiştir.

Xmlnodetype	Parça İçerebilir
Öğe	Geçerli herhangi bir öğe içeriği (örneğin, herhangi bir öğe bileşimi, açıklamalar, işleme yönergeleri, cdata, metin ve varlık başvuruları).
Özellik	Özniteliğin değeri (tırnak işaretleri içindeki bölüm).
Belge	Xml belgesinin tamamının içeriği; bu, belge düzeyi kurallarını zorunlu kılar.

Okuyucu, akışın kodlamasını belirlemek için aşağıdaki adımları kullanır:

1. Kodlamayı XmlParserContext.Encoding belirlemek için özelliğini denetler.

2. Encoding özelliği isenull, okuyucu akışın başında bayt sırası işaretini denetler.

3. Encoding özelliği ise nullve bayt sırası işareti bulunamazsa, okuyucu akışın UTF-8'de kodlanmış olduğunu varsayar.

Bu okuyucu belge türü tanımı (DTD) kullanarak doğrulama yapacaksa (yani ValidationType.DTD ValidationType veya ValidationType.Auto olarak ayarlanmışsa), XmlParserContext oluşturucuda belirtilen tüm gerekli DocumentType bilgilerini sağlamalıdır.

Uyarı

DTD kullanarak bir parçanın doğrulanması mümkün değildir. Tanım gereği DTD, doğrulama için belgenin tamamının yüklenmesini gerektirir.

Bu okuyucu XML-Data Azaltılmış (XDR) veya XML Şeması tanım dili (XSD) şemalarını kullanarak doğrulayacaksa, şemaları içeren öğesini belirtmek XmlSchemaCollection için özelliğini kullanın Schemas (yani DocumentType XmlParserContext bilgilerini sağlaması gerekmez).

Ayrıca bkz.

• XmlReader

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Kaynak:

XmlValidatingReader.cs

Belirtilen değerlerle sınıfının yeni bir örneğini XmlValidatingReader başlatır.

public:
 XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReader

Public Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)

Parametreler

xmlFragment

String

Ayrıştırmak için XML parçasını içeren dize.

fragType

XmlNodeType

XmlNodeType XML parçasının sayısı. Bu, parça dizesinin ne içerebileceğini de belirler (aşağıdaki tabloya bakın).

context

XmlParserContext

XmlParserContext XML parçasının ayrıştırılacağı yer. Bu, kullanılacak, kodlama, ad alanı kapsamı, geçerli xml:lang ve xml:space kapsamını içerir NameTable .

Özel durumlar

XmlException

fragType aşağıdaki tabloda listelenen düğüm türlerinden biri değildir.

Açıklamalar

Uyarı

XmlValidatingReader.NET Framework 2.0'da sınıf kullanımdan kaldırıldı. sınıfını ve Create yöntemini kullanarak XmlReaderSettings bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu oluşturucu, verilen dizeyi XML parçası olarak ayrıştırıyor. XML parçası bir öğe veya öznitelikse, iyi biçimlendirilmiş XML belgeleri için kök düzey kurallarını atlayabilirsiniz. Bu oluşturucu, içinden ReadInnerXmldöndürülen dizeleri işleyebilir.

Aşağıdaki tabloda, okuyucunun farklı düğüm türlerinin her biri için fragType geçerli değerleri ve ayrıştırma şekli listelenmiştir.

Xmlnodetype	Parça İçerebilir
Öğe	Geçerli herhangi bir öğe içeriği (örneğin, herhangi bir öğe bileşimi, açıklamalar, işleme yönergeleri, cdata, metin ve varlık başvuruları).
Özellik	Özniteliğin değeri (tırnak işaretleri içindeki bölüm).
Belge	Xml belgesinin tamamının içeriği; bu, belge düzeyi kurallarını zorunlu kılar.

Bu okuyucu belge türü tanımını (DTD) kullanarak doğrulayacaksa (yani ValidationType.DTD ValidationType veya ValidationType.Auto olarak ayarlandıysa), XmlParserContext oluşturucuda belirtilen tüm gerekli DocumentType bilgilerini sağlamalıdır.

Uyarı

DTD kullanarak bir parçanın doğrulanması mümkün değildir. Tanıma göre DTD, doğrulama için belgenin tamamının yüklenmesini gerektirir.

Bu okuyucu XML-Data Azaltılmış (XDR) veya XML Şeması tanım dili (XSD) şemalarını kullanarak doğrulayacaksa, şemaları içeren öğesini belirtmek XmlSchemaCollection için özelliğini kullanın Schemas (XmlParserContextDocumentType bilgilerini sağlaması gerekmez).

Ayrıca bkz.

• XmlReader