XmlReader.ReadContentAsObject Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

InvalidCastException

Il tentativo di cast non è valido.

FormatException

Il formato della stringa non è valido.

InvalidOperationException

È 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.