Freigeben über


XmlValidatingReader.ReadString Methode

Definition

Liest den Inhalt eines Elements oder Eines Textknotens als Zeichenfolge.

public:
 override System::String ^ ReadString();
public override string ReadString();
override this.ReadString : unit -> string
Public Overrides Function ReadString () As String

Gibt zurück

Der Inhalt des Elements oder des Textknotens. Dies kann eine leere Zeichenfolge sein, wenn der Leser auf etwas anderes als einem Element oder Textknoten positioniert ist oder wenn im aktuellen Kontext kein Textinhalt mehr zurückgegeben werden soll.

Hinweise

Der Textknoten kann entweder ein Element oder ein Attributtextknoten sein.

Hinweis

Die XmlValidatingReader Klasse ist in .NET Framework 2.0 veraltet. Sie können eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

Wenn sie auf einem Element positioniert ist, ReadString verkettet sie alle Text-, signifikanten Leerraum-, Leer- und CDATA-Abschnittsknotentypen zusammen und gibt die verketteten Daten als Elementinhalt zurück. Der Leser stoppt, wenn markups gefunden werden, einschließlich Kommentaren und Verarbeitungsanweisungen. Dies kann in einem gemischten Inhaltsmodell oder beim Lesen eines Elementendtags auftreten.

Wenn sie auf einem Textknoten positioniert ist, ReadString führt die gleiche Verkettung vom Textknoten zum Elementendtag aus. Wenn der Leser auf einem Attributtextknoten positioniert ist, ReadString hat die gleiche Funktionalität wie die Position des Lesers auf dem Elementstarttag. Es gibt alle verketteten Elementtextknoten zurück.

Die EntityHandling Eigenschaft bestimmt wie ReadString folgt:

Wert Beschreibung
ExpandEntities Gibt erweiterte Zeichen und allgemeine Entitäten zurück. Dies ist die Standardoption.
ExpandCharEntities Gibt den Textinhalt bis zu einem allgemeinen Entitätsverweis zurück, aber nicht. Dies bedeutet, dass eine allgemeine Entität das Beenden von ReadString bewirkt. Sie müssen den Schritt für den Entitätsverweis aufrufen Read .

Gilt für:

Weitere Informationen