Udostępnij za pośrednictwem


XmlReader.ReadElementString Metoda

Definicja

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

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

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.

Dotyczy

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

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.

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.

Dotyczy

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

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.

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.

Dotyczy