XmlReader.ReadContentAsObject 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.
Legge il contenuto di testo nella posizione corrente come .Object
public:
virtual System::Object ^ ReadContentAsObject();public virtual object ReadContentAsObject();abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> objPublic Overridable Function ReadContentAsObject () As ObjectRestituisce
Contenuto di testo come oggetto CLR (Common Language Runtime) più appropriato.
Eccezioni
Il cast tentato non è valido.
Formato stringa non valido.
È stato chiamato un XmlReader metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
Commenti
Questo metodo concatena testo, spazi vuoti, spazi vuoti significativi e sezioni CDATA e ignora eventuali commenti o istruzioni di elaborazione. I riferimenti alle entità vengono risolti automaticamente.
Se il contenuto è tipizzato, il lettore restituisce un CLR boxed del tipo più appropriato, specificato dalla ValueType proprietà . Se il contenuto è un tipo di elenco, il lettore restituisce una matrice di oggetti boxed del tipo appropriato.
Annotazioni
Se si verifica un errore di convalida durante l'analisi del contenuto e il lettore è un XmlReader oggetto creato dal Create metodo , il lettore restituisce il contenuto come stringa. In altre parole, quando si verifica un errore di convalida o un avviso, il contenuto viene considerato non tipizzato.
Se il contenuto non è tipizzato, il lettore restituisce il contenuto come stringa.
Nella tabella seguente viene descritto come questo metodo gestisce ogni tipo di nodo.
| Xmlnodetype | Valore restituito | Comportamento lettore |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Contenuto concatenato di testo, CDATA, spazi vuoti e nodi di spazi vuoti significativi convertiti nel tipo richiesto. | Passa al tag dell'elemento iniziale o dell'elemento finale successivo. I riferimenti alle entità vengono espansi automaticamente. |
Attribute |
Uguale alla chiamata XmlConvert.ToXxx al valore dell'attributo. |
Il lettore rimane nella posizione corrente |
CommentProcessingInstruction |
Ignora l'istruzione di elaborazione o il commento e legge il contenuto di testo concatenato che segue il PI o il commento. | Passa al tag dell'elemento iniziale o dell'elemento finale successivo. I riferimenti alle entità vengono espansi automaticamente. |
EndElement |
Valore dell'elemento se il lettore è un lettore di convalida dello schema (ValidationType è impostato su Schema). In caso contrario, una stringa vuota. | Il lettore rimane nella posizione corrente. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Viene generata un'eccezione InvalidOperationException . | Non definito, anche se in genere il lettore rimane nella posizione corrente. |
Per altre informazioni, vedere la sezione Osservazioni della XmlReader pagina di riferimento e la raccomandazione W3C XML Schema Part 2: Datatypes .
Per la versione asincrona di questo metodo, vedere ReadContentAsObjectAsync.
