XmlReader.ReadContentAsObject Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Odczytuje zawartość tekstową w bieżącej pozycji jako 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

Zwraca

Object

Zawartość tekstowa jako najbardziej odpowiedni obiekt środowiska uruchomieniowego języka wspólnego (CLR).

Wyjątki

InvalidCastException

Próba rzutowania jest nieprawidłowa.

FormatException

Format ciągu jest nieprawidłowy.

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda łączy tekst, biały odstęp, znaczne odstępy i sekcje CDATA oraz pomija wszelkie komentarze lub instrukcje przetwarzania. Odwołania do jednostek są automatycznie rozwiązywane.

Jeśli zawartość jest typowana, czytnik zwraca pole CLR najbardziej odpowiedniego typu określonego przez ValueType właściwość . Jeśli zawartość jest typem listy, czytnik zwraca tablicę pól obiektów odpowiedniego typu.

Uwaga

Jeśli podczas analizowania zawartości wystąpi błąd walidacji, a czytelnik jest obiektem XmlReader utworzonym przez Create metodę, czytelnik zwraca zawartość jako ciąg. Innymi słowy, gdy wystąpi błąd weryfikacji lub ostrzeżenie, zawartość jest uważana za nietypową.

Jeśli zawartość nie jest wpisywana, czytnik zwraca zawartość jako ciąg.

W poniższej tabeli opisano sposób traktowania poszczególnych typów węzłów przez tę metodę.

XmlNodeType	Wartość zwracana	Zachowanie czytelnika
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Połączona zawartość tekstu, CDATA, odstępu i znaczących węzłów odstępów przekonwertowanych na żądany typ.	Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
Attribute	Tak samo jak wywołanie XmlConvert.ToXxx wartości atrybutu.	Czytelnik pozostaje w bieżącej pozycji
Comment ProcessingInstruction	Ignoruje instrukcję przetwarzania (PI) lub komentarz i odczytuje połączoną zawartość tekst, która jest zgodna z danymi pi lub komentarzem.	Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
EndElement	Wartość elementu, jeśli czytnik jest modułem sprawdzania poprawności schematu (ValidationType jest ustawiona na Schemawartość ); w przeciwnym razie pusty ciąg.	Czytelnik pozostaje w bieżącej pozycji.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Jest InvalidOperationException zgłaszany.	Niezdefiniowane, chociaż zazwyczaj czytelnik pozostaje w bieżącej pozycji.

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader i rekomendację W3C XML Schema Part 2: Datatypes (Schemat XML W3C— część 2: zalecenia dotyczące typów danych ).

Aby uzyskać asynchroniczną wersję tej metody, zobacz ReadContentAsObjectAsync.