Condividi tramite


XmlValidatingReader Costruttori

Definizione

Inizializza una nuova istanza della classe XmlValidatingReader.

Overload

Nome Descrizione
XmlValidatingReader(XmlReader)

Inizializza una nuova istanza della XmlValidatingReader classe che convalida il contenuto restituito dall'oggetto specificato XmlReader.

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Inizializza una nuova istanza della XmlValidatingReader classe con i valori specificati.

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Inizializza una nuova istanza della XmlValidatingReader classe con i valori specificati.

XmlValidatingReader(XmlReader)

Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs

Inizializza una nuova istanza della XmlValidatingReader classe che convalida il contenuto restituito dall'oggetto specificato XmlReader.

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)

Parametri

reader
XmlReader

Oggetto XmlReader da cui leggere durante la convalida. L'implementazione corrente supporta solo XmlTextReader.

Eccezioni

Il lettore specificato non è un oggetto XmlTextReader.

Commenti

Annotazioni

La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Tutti i nodi restituiti dall'oggetto specificato XmlReader vengono restituiti anche da questo lettore di convalida, quindi non si verifica alcuna perdita di informazioni nel processo. I nuovi nodi non restituiti dal lettore sottostante possono essere aggiunti da questo lettore(ad esempio, attributi predefiniti e elementi figlio di un riferimento a un'entità). Tutte le proprietà impostate sull'oggetto specificato XmlTextReader si applicano anche a questo lettore di convalida. Ad esempio, se il lettore fornito dispone di WhitespaceHandling.None impostato, questo lettore di convalida ignora anche gli spazi vuoti.

Quando sono necessarie definizioni di tipi di documento esterni (DTD) o schemi per la convalida, la XmlResolver proprietà imposta l'oggetto XmlResolver da usare per la risoluzione delle risorse esterne.

Vedi anche

Si applica a

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs

Inizializza una nuova istanza della XmlValidatingReader classe con i valori specificati.

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)

Parametri

xmlFragment
Stream

Flusso contenente il frammento XML da analizzare.

fragType
XmlNodeType

Oggetto XmlNodeType del frammento XML. Ciò determina il contenuto del frammento (vedere la tabella seguente).

context
XmlParserContext

Oggetto XmlParserContext in cui deve essere analizzato il frammento XML. Include l'oggetto XmlNameTable da usare, codifica, ambito dello spazio dei nomi, ambito corrente xml:lange xml:space ambito.

Eccezioni

fragType non è uno dei tipi di nodo elencati nella tabella seguente.

Commenti

Annotazioni

La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo costruttore analizza la stringa specificata come frammento di XML. Se il frammento XML è un elemento o un attributo, è possibile ignorare le regole del livello radice per i documenti XML ben formati.

Nella tabella seguente sono elencati i valori validi per fragType e il modo in cui il lettore analizza ognuno dei diversi tipi di nodo.

Xmlnodetype Frammento può contenere
Elemento Qualsiasi contenuto di elemento valido(ad esempio, qualsiasi combinazione di elementi, commenti, istruzioni di elaborazione, cdata, testo ed entità riferimenti).
Attribute Valore di un attributo (la parte all'interno delle virgolette).
Documento Contenuto di un intero documento XML; in questo modo vengono applicate le regole a livello di documento.

Il lettore usa i passaggi seguenti per determinare la codifica del flusso:

  1. Controlla la XmlParserContext.Encoding proprietà per determinare la codifica.

  2. Se la Encoding proprietà è null, il lettore verifica la presenza di un contrassegno di ordine di byte all'inizio del flusso.

  3. Se la Encoding proprietà è nulle non viene trovato alcun contrassegno di ordine dei byte, il lettore presuppone che il flusso sia codificato in UTF-8.

Se questo lettore eseguirà la convalida usando la definizione del tipo di documento (DTD), ValidationType ovvero è impostata su ValidationType.DTD o ValidationType.Auto, l'oggetto XmlParserContext specificato nel costruttore deve fornire tutte le informazioni documentType necessarie.

Annotazioni

Non è possibile convalidare un frammento usando un DTD. Per definizione, un DTD richiede il caricamento di un intero documento per la convalida.

Se questo lettore verrà convalidato utilizzando XML-Data schema XDR (Reduced) o XSD (XML Schema Definition Language), utilizzare la Schemas proprietà per specificare l'oggetto XmlSchemaCollection che contiene gli schemi, XmlParserContext ovvero non è necessario fornire le informazioni di DocumentType.

Vedi anche

Si applica a

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs
Origine:
XmlValidatingReader.cs

Inizializza una nuova istanza della XmlValidatingReader classe con i valori specificati.

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)

Parametri

xmlFragment
String

Stringa contenente il frammento XML da analizzare.

fragType
XmlNodeType

Oggetto XmlNodeType del frammento XML. Ciò determina anche la stringa del frammento che può contenere (vedere la tabella seguente).

context
XmlParserContext

Oggetto XmlParserContext in cui deve essere analizzato il frammento XML. Include l'oggetto NameTable da usare, codifica, ambito dello spazio dei nomi, xml:lang corrente e ambito xml:space.

Eccezioni

fragType non è uno dei tipi di nodo elencati nella tabella seguente.

Commenti

Annotazioni

La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo costruttore analizza la stringa specificata come frammento di XML. Se il frammento XML è un elemento o un attributo, è possibile ignorare le regole del livello radice per i documenti XML ben formati. Questo costruttore può gestire le stringhe restituite da ReadInnerXml.

Nella tabella seguente sono elencati i valori validi per fragType e il modo in cui il lettore analizza ognuno dei diversi tipi di nodo.

Xmlnodetype Frammento può contenere
Elemento Qualsiasi contenuto di elemento valido(ad esempio, qualsiasi combinazione di elementi, commenti, istruzioni di elaborazione, cdata, testo ed entità riferimenti).
Attribute Valore di un attributo (la parte all'interno delle virgolette).
Documento Contenuto di un intero documento XML; in questo modo vengono applicate le regole a livello di documento.

Se il lettore eseguirà la convalida usando la definizione del tipo di documento (DTD), ValidationType ovvero è impostata su ValidationType.DTD o ValidationType.Auto, l'oggetto XmlParserContext specificato nel costruttore deve fornire tutte le informazioni necessarie sul documentType.

Annotazioni

Non è possibile convalidare un frammento usando DTD. Per definizione DTD è necessario caricare un intero documento per la convalida.

Se il lettore eseguirà la convalida utilizzando XML-Data gli schemi XDR (Reduced) o XSD (Reduced) o XML Schema Definition Language (XSD), utilizzare la Schemas proprietà per specificare l'oggetto XmlSchemaCollection che contiene gli schemi ( XmlParserContext non è necessario fornire le informazioni di DocumentType).

Vedi anche

Si applica a