XPathNavigator.CheckValidity(XmlSchemaSet, ValidationEventHandler) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Verifica che i dati XML nell'oggetto XPathNavigator siano conformi allo schema XSD (XML Schema Definition Language) fornito.
public:
virtual bool CheckValidity(System::Xml::Schema::XmlSchemaSet ^ schemas, System::Xml::Schema::ValidationEventHandler ^ validationEventHandler);
public virtual bool CheckValidity(System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler);
abstract member CheckValidity : System.Xml.Schema.XmlSchemaSet * System.Xml.Schema.ValidationEventHandler -> bool
override this.CheckValidity : System.Xml.Schema.XmlSchemaSet * System.Xml.Schema.ValidationEventHandler -> bool
Public Overridable Function CheckValidity (schemas As XmlSchemaSet, validationEventHandler As ValidationEventHandler) As Boolean
Parametri
- schemas
- XmlSchemaSet
Oggetto XmlSchemaSet contenente gli schemi utilizzati per convalidare i dati XML contenuti in XPathNavigator.
- validationEventHandler
- ValidationEventHandler
Oggetto ValidationEventHandler che riceve informazioni sugli avvisi ed errori di convalida dello schema.
Restituisce
true se non si sono verificati errori di convalida dello schema; in caso contrario, false.
Eccezioni
Si è verificato un errore di convalida dello schema e non è stato specificato alcun ValidationEventHandler valore per gestire gli errori di convalida.
L'oggetto XPathNavigator è posizionato in un nodo che non è un elemento, un attributo o il nodo radice o non sono presenti informazioni sul tipo per eseguire la convalida.
Il CheckValidity(XmlSchemaSet, ValidationEventHandler) metodo è stato chiamato con un XmlSchemaSet parametro quando XPathNavigator non è stato posizionato sul nodo radice dei dati XML.
Commenti
Il CheckValidity metodo verifica che i dati XML contenuti nell'oggetto XPathNavigator siano conformi a un tipo globale o a una dichiarazione nello schema o negli schemi forniti in XmlSchemaSet.
Il CheckValidity metodo non esegue l'aumento dell'infoset. Ciò significa che le impostazioni predefinite dello schema non vengono applicate, i valori di testo non vengono convertiti in valori atomici e non vengono associate nuove informazioni sul tipo agli elementi di informazioni.
Gli
xsi:schemaLocationschemi oxsi:noNamespaceSchemaLocationgli hint nei dati XML di vengono ignorati.Se l'oggetto XPathNavigator è posizionato in un nodo documento, il processo di convalida include il controllo dell'univocità e dei vincoli di riferimento (
xs:ID,xs:IDREF,xs:keyxs:keyref, exs:unique). In caso contrario, questi controlli vengono omessi.Se l'oggetto XmlSchemaSet passato come parametro è
nulle l'oggetto XPathNavigator viene posizionato in un nodo di elemento, le informazioni sul tipo esposte dalla SchemaInfo proprietà della SchemaType proprietà vengono usate per verificare la validità del nodo. Se l'oggetto XmlSchemaSet passato come parametro ènulle l'oggetto XPathNavigator viene posizionato nel nodo radice, viene utilizzata la SchemaInfo proprietà dell'elemento documento ( ovvero l'elemento figlio del nodo radice). In entrambi i casi se la SchemaType proprietà della proprietà dell'elemento SchemaInfo ènulle l'oggetto XmlSchemaSet passato come parametro ènull, viene generata un'eccezione InvalidOperationException perché non sono presenti informazioni sul tipo da usare per eseguire la convalida.