XmlReader.ReadContentAsString Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Odczytuje zawartość tekstową w bieżącej pozycji jako String obiekt.

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString ();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

Zwraca

String

Zawartość tekstowa String jako obiekt.

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.

Ta metoda może służyć do konwertowania wartości typowych na ciąg lub odczytywania zawartości tekstowej podczas pomijania komentarzy i instrukcji przetwarzania.

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`	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 ReadContentAsStringAsync.

Dotyczy