XmlValidatingReader Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe XmlValidatingReader.
Surcharges
| Nom | Description |
|---|---|
| XmlValidatingReader(XmlReader) |
Initialise une nouvelle instance de la |
| XmlValidatingReader(Stream, XmlNodeType, XmlParserContext) |
Initialise une nouvelle instance de la |
| XmlValidatingReader(String, XmlNodeType, XmlParserContext) |
Initialise une nouvelle instance de la |
XmlValidatingReader(XmlReader)
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
Initialise une nouvelle instance de la XmlValidatingReader classe qui valide le contenu retourné à partir de l’élément donné XmlReader.
public:
XmlValidatingReader(System::Xml::XmlReader ^ reader);public XmlValidatingReader(System.Xml.XmlReader reader);new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReaderPublic Sub New (reader As XmlReader)Paramètres
- reader
- XmlReader
XmlReader À lire lors de la validation. L’implémentation actuelle prend uniquement XmlTextReaderen charge .
Exceptions
Le lecteur spécifié n’est pas un XmlTextReader.
Remarques
Note
La XmlValidatingReader classe est obsolète dans .NET Framework 2.0. Vous pouvez créer une instance de XmlReader validation à l’aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.
Tous les nœuds retournés à partir de l’élément donné XmlReader sont également retournés par ce lecteur de validation. Il n’y a donc aucune perte d’informations dans le processus. Les nouveaux nœuds non retournés par le lecteur sous-jacent peuvent être ajoutés par ce lecteur (par exemple, les attributs par défaut et les enfants d’une référence d’entité). Toutes les propriétés définies sur l’élément donné XmlTextReader s’appliquent également à ce lecteur de validation. Par exemple, si le lecteur fourni avait whitespaceHandling.None défini, ce lecteur de validation ignore également l’espace blanc.
Lorsque des définitions de type de document externe (DTD) ou des schémas sont nécessaires pour la validation, la XmlResolver propriété définit l’objet XmlResolver à utiliser pour résoudre les ressources externes.
Voir aussi
S’applique à
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
Initialise une nouvelle instance de la XmlValidatingReader classe avec les valeurs spécifiées.
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.XmlValidatingReaderPublic Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)Paramètres
- xmlFragment
- Stream
Flux contenant le fragment XML à analyser.
- fragType
- XmlNodeType
Fragment XmlNodeType XML. Cela détermine ce que le fragment peut contenir (voir le tableau ci-dessous).
- context
- XmlParserContext
XmlParserContext Dans lequel le fragment XML doit être analysé. Cela inclut l’utilisation, l’encodage, l’étendue XmlNameTable d’espace de noms, l’étendue actuelle xml:langet l’étendue xml:space .
Exceptions
fragType n’est pas l’un des types de nœuds répertoriés dans le tableau ci-dessous.
Remarques
Note
La XmlValidatingReader classe est obsolète dans .NET Framework 2.0. Vous pouvez créer une instance de XmlReader validation à l’aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.
Ce constructeur analyse la chaîne donnée en tant que fragment de XML. Si le fragment XML est un élément ou un attribut, vous pouvez contourner les règles de niveau racine pour les documents XML bien formés.
Le tableau suivant répertorie les valeurs valides pour fragType et la façon dont le lecteur analyse chacun des différents types de nœuds.
| XmlNodeType | Le fragment peut contenir |
|---|---|
| Élément | Tout contenu d’élément valide (par exemple, toute combinaison d’éléments, commentaires, instructions de traitement, cdata, texte et références d’entité). |
| Caractéristique | Valeur d’un attribut (partie à l’intérieur des guillemets). |
| Document | Contenu d’un document XML entier ; cela applique des règles de niveau document. |
Le lecteur utilise les étapes suivantes pour déterminer l’encodage du flux :
Vérifie la XmlParserContext.Encoding propriété pour déterminer l’encodage.
Si la
Encodingpropriété estnull, le lecteur recherche une marque d’ordre d’octet au début du flux.Si la
Encodingpropriété estnull, et qu’aucune marque d’ordre d’octet n’est trouvée, le lecteur suppose que le flux est encodé en UTF-8.
Si ce lecteur valide à l’aide de la définition de type de document (DTD) (autrement dit, ValidationType est défini sur ValidationType.DTD ou ValidationType.Auto), le XmlParserContext constructeur spécifié doit fournir toutes les informations DocumentType nécessaires.
Note
Il n’est pas possible de valider un fragment à l’aide d’un DTD. Par définition, une DTD exige qu’un document entier soit chargé pour validation.
Si ce lecteur sera validé à l’aide d'XML-Data schémas XDR (Réduit) ou XDR (XML Schema Definition Language), utilisez la Schemas propriété pour spécifier les XmlSchemaCollection schémas (autrement dit, il XmlParserContext n’est pas nécessaire de fournir les informations DocumentType).
Voir aussi
S’applique à
XmlValidatingReader(String, XmlNodeType, XmlParserContext)
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
- Source:
- XmlValidatingReader.cs
Initialise une nouvelle instance de la XmlValidatingReader classe avec les valeurs spécifiées.
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.XmlValidatingReaderPublic Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)Paramètres
- xmlFragment
- String
Chaîne contenant le fragment XML à analyser.
- fragType
- XmlNodeType
Fragment XmlNodeType XML. Cela détermine également ce que la chaîne de fragment peut contenir (voir le tableau ci-dessous).
- context
- XmlParserContext
XmlParserContext Dans lequel le fragment XML doit être analysé. Cela inclut l’utilisation, l’encodage, l’étendue NameTable d’espace de noms, l’étendue xml :lang actuelle et xml :space.
Exceptions
fragType n’est pas l’un des types de nœuds répertoriés dans le tableau ci-dessous.
Remarques
Note
La XmlValidatingReader classe est obsolète dans .NET Framework 2.0. Vous pouvez créer une instance de XmlReader validation à l’aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.
Ce constructeur analyse la chaîne donnée en tant que fragment de XML. Si le fragment XML est un élément ou un attribut, vous pouvez contourner les règles de niveau racine pour les documents XML bien formés. Ce constructeur peut gérer les chaînes retournées par ReadInnerXml.
Le tableau suivant répertorie les valeurs valides pour fragType et la façon dont le lecteur analyse chacun des différents types de nœuds.
| XmlNodeType | Le fragment peut contenir |
|---|---|
| Élément | Tout contenu d’élément valide (par exemple, toute combinaison d’éléments, commentaires, instructions de traitement, cdata, texte et références d’entité). |
| Caractéristique | Valeur d’un attribut (partie à l’intérieur des guillemets). |
| Document | Contenu d’un document XML entier ; cela applique des règles de niveau document. |
Si ce lecteur sera validé à l’aide de la définition de type de document (DTD) (autrement dit, ValidationType est défini sur ValidationType.DTD ou ValidationType.Auto), le XmlParserContext constructeur spécifié doit fournir toutes les informations DocumentType nécessaires.
Note
Il n’est pas possible de valider un fragment à l’aide de DTD. Par définition, la DTD nécessite le chargement d’un document entier pour la validation.
Si ce lecteur valide en utilisant XML-Data des schémas XDR (Réduits) ou XDR (XML Schema Definition Language), utilisez la Schemas propriété pour spécifier les XmlSchemaCollection schémas qui contiennent les schémas (le XmlParserContext documentType n’a pas besoin de fournir les informations DocumentType).
