XmlReader.ReadContentAsObject Metodo

Definizione

Legge il contenuto di testo nella posizione corrente come Object.Reads the text content at the current position as an 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

Il contenuto di testo come oggetto CLR (Common Language Runtime) più appropriato.The text content as the most appropriate common language runtime (CLR) object.

Eccezioni

Il tentativo di cast non è valido.The attempted cast is not valid.

Il formato della stringa non è valido.The string format is not valid.

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente.An XmlReader method was called before a previous asynchronous operation finished. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Commenti

Questo metodo concatena il testo, gli spazi vuoti, gli spazi vuoti significativi e le sezioni CDATA e ignora eventuali commenti o istruzioni di elaborazione.This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. I riferimenti alle entità vengono risolti automaticamente.Entity references are automatically resolved.

Se il contenuto è tipizzato, il lettore restituisce un CLR boxed del tipo più appropriato, specificato dalla ValueType proprietà.If the content is typed, the reader returns a boxed CLR of the most appropriate type, specified by the ValueType property. Se il contenuto è un tipo di elenco, il lettore restituisce una matrice di oggetti boxed del tipo appropriato.If the content is a list type, the reader returns an array of boxed objects of the appropriate type.

Nota

Se si verifica un errore XmlReader Create di convalida durante l'analisi del contenuto e il Reader è un oggetto creato dal metodo, il lettore restituisce il contenuto sotto forma di stringa.If a validation error occurs while parsing the content and the reader is an XmlReader object created by the Create method, the reader returns the content as a string. In altre parole, quando si verifica un errore o un avviso di convalida, il contenuto viene considerato non tipizzato.In other words when a validation error or warning occurs, the content is considered to be untyped.

Se il contenuto non è tipizzato, il lettore restituirà il contenuto come stringa.If the content is not typed, the reader returns the content as a string.

Nella tabella seguente viene descritto il modo in cui questo metodo considera ogni tipo di nodo.The following table describes how this method treats each node type.

XmlNodeTypeXmlNodeType Valore restituitoReturn value Comportamento del lettoreReader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Contenuto concatenato di nodi di tipo text, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. Si sposta al successivo tag di fine o di inizio dell'elemento.Moves to the next start element or end element tag. I riferimenti a entità vengono espansi automaticamente.Entity references are automatically expanded.
Attribute Equivale a chiamare XmlConvert.ToXxx sul valore dell'attributo.Same as calling XmlConvert.ToXxx on the attribute value. Il lettore rimane nella posizione correnteThe reader remains in the current position
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.Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. Si sposta al successivo tag di fine o di inizio dell'elemento.Moves to the next start element or end element tag. I riferimenti a entità vengono espansi automaticamente.Entity references are automatically expanded.
EndElement Valore dell'elemento se il Reader è un lettore di convalida dello schema (ValidationType è impostato su Schema); in caso contrario, una stringa vuota.The value of the element if the reader is a schema validating reader (ValidationType is set to Schema); otherwise an empty string. Il lettore resta nella posizione corrente.The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Viene generato un tipo InvalidOperationException.An InvalidOperationException is thrown. Non definito, sebbene in genere il lettore resti nella posizione corrente.Undefined, although typically the reader remains in the current position.

Per ulteriori informazioni, vedere la sezione Osservazioni della pagina XmlReader di riferimento e W3C XML Schema Part 2: Indicazione DataTypes.For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

Per la versione asincrona di questo metodo, vedere ReadContentAsObjectAsync.For the asynchronous version of this method, see ReadContentAsObjectAsync.

Si applica a