Condividi tramite


XmlReader.ReadContentAsObject Metodo

Definizione

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 -> obj
Public Overridable Function ReadContentAsObject () As Object

Restituisce

Object

Contenuto di testo come oggetto CLR (Common Language Runtime) più appropriato.

Eccezioni

Il tentativo di cast non è valido.

Il formato della stringa non è valido.

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Commenti

Questo metodo concatena il testo, lo spazio vuoto, lo spazio vuoto significativo e le sezioni CDATA e ignora eventuali commenti o istruzioni di elaborazione. I riferimenti alle entità vengono risolti automaticamente.

Se il contenuto viene digitato, 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.

Nota

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 restituirà il contenuto come stringa.

Nella tabella seguente viene descritto il modo in cui questo metodo tratta ogni tipo di nodo.

XmlNodeType Valore restituito Comportamento del lettore
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Contenuto concatenato di nodi di tipo text, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto. Si sposta al successivo tag di fine o di inizio dell'elemento. I riferimenti a entità vengono espansi automaticamente.
Attribute Uguale alla chiamata XmlConvert.ToXxx al valore dell'attributo. Il lettore rimane nella posizione corrente
Comment

ProcessingInstruction
Ignora l'istruzione di elaborazione (PI, Processing Instruction) o il commento e legge il contenuto del testo concatenato successivo all'istruzione di elaborazione o al commento. Si sposta al successivo tag di fine o di inizio dell'elemento. I riferimenti a entità vengono espansi automaticamente.
EndElement Il valore dell'elemento se il lettore è un lettore di convalida dello schema (ValidationType è impostato su Schema). In caso contrario, una stringa vuota. Il lettore resta nella posizione corrente.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Viene generato un tipo InvalidOperationException. Non definito, sebbene in genere il lettore resti 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.

Si applica a