XmlReader.ReadElementString Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Odczytuje proste elementy tylko do tekstu. Zalecamy jednak użycie ReadElementContentAsString metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.

Przeciążenia

ReadElementString()	Odczytuje element tylko tekst. Zalecamy jednak użycie ReadElementContentAsString() metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.
ReadElementString(String)	Sprawdza, czy Name właściwość znalezionego elementu jest zgodna z danym ciągiem przed odczytaniem elementu tylko do tekstu. Zalecamy jednak użycie ReadElementContentAsString() metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.
ReadElementString(String, String)	Sprawdza, czy LocalName właściwości i NamespaceURI znalezionego elementu są zgodne z podanymi ciągami przed odczytaniem elementu tylko do tekstu. Zalecamy jednak użycie ReadElementContentAsString(String, String) metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.

Uwagi

Zalecamy użycie ReadElementContentAsString metody do odczytania elementu tekstowego.

ReadElementString()

Odczytuje element tylko tekst. Zalecamy jednak użycie ReadElementContentAsString() metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.

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

public virtual string ReadElementString ();

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

Public Overridable Function ReadElementString () As String

Zwraca

String

Tekst zawarty w odczytanych elementach. Pusty ciąg, jeśli element jest pusty.

Wyjątki

XmlException

Następny węzeł zawartości nie jest tagiem początkowym; lub znaleziony element nie zawiera prostej wartości tekstowej.

InvalidOperationException

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

Uwagi

Zalecamy użycie ReadElementContentAsString() metody do odczytania elementu tekstowego.

ReadElementString(String)

Sprawdza, czy Name właściwość znalezionego elementu jest zgodna z danym ciągiem przed odczytaniem elementu tylko do tekstu. Zalecamy jednak użycie ReadElementContentAsString() metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.

public:
 virtual System::String ^ ReadElementString(System::String ^ name);

public virtual string ReadElementString (string name);

abstract member ReadElementString : string -> string
override this.ReadElementString : string -> string

Public Overridable Function ReadElementString (name As String) As String

Parametry

name

String

Nazwa do sprawdzenia.

Zwraca

String

Tekst zawarty w odczytanych elementach. Pusty ciąg, jeśli element jest pusty.

Wyjątki

XmlException

Jeśli następny węzeł zawartości nie jest tagiem początkowym; jeśli element Name nie pasuje do podanego argumentu; lub jeśli znaleziony element nie zawiera prostej wartości tekstowej.

InvalidOperationException

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

Uwagi

Zalecamy użycie ReadElementContentAsString() metody do odczytania elementu tekstowego.

ReadElementString(String, String)

Sprawdza, czy LocalName właściwości i NamespaceURI znalezionego elementu są zgodne z podanymi ciągami przed odczytaniem elementu tylko do tekstu. Zalecamy jednak użycie ReadElementContentAsString(String, String) metody , ponieważ zapewnia ona prostszy sposób obsługi tej operacji.

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);

public virtual string ReadElementString (string localname, string ns);

abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string

Public Overridable Function ReadElementString (localname As String, ns As String) As String

Parametry

localname

String

Nazwa lokalna do sprawdzenia.

ns

String

Identyfikator URI przestrzeni nazw do sprawdzenia.

Zwraca

String

Tekst zawarty w odczytanych elementach. Pusty ciąg, jeśli element jest pusty.

Wyjątki

XmlException

Jeśli następny węzeł zawartości nie jest tagiem początkowym; jeśli element LocalName lub NamespaceURI nie pasuje do podanych argumentów; lub jeśli znaleziony element nie zawiera prostej wartości tekstowej.

InvalidOperationException

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

Uwagi

Zalecamy użycie ReadElementContentAsString(String, String) metody do odczytania elementu tekstowego.