XmlReader.ReadElementString Metoda

Definicja

Odczytuje proste elementy tylko tekstowe.Reads the simple text-only elements. Zaleca się jednak użycie metody ReadElementContentAsString, ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString method instead, because it provides a more straightforward way to handle this operation.

Przeciążenia

ReadElementString()

Odczytuje element tekstowy.Reads a text-only element. Zaleca się jednak użycie metody ReadElementContentAsString(), ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String)

Sprawdza, czy właściwość Name elementu znalezionych pasuje do podanego ciągu przed odczytaniem elementu tekstowego.Checks that the Name property of the element found matches the given string before reading a text-only element. Zaleca się jednak użycie metody ReadElementContentAsString(), ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String, String)

Sprawdza, czy właściwości LocalName i NamespaceURI elementu znalezione są zgodne z podanymi ciągami przed odczytem elementu tekstowego.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. Zaleca się jednak użycie metody ReadElementContentAsString(String, String), ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

Uwagi

Zalecamy użycie metody ReadElementContentAsString w celu odczytania elementu tekstowego.We recommend that you use the ReadElementContentAsString method to read a text element.

ReadElementString()

Odczytuje element tekstowy.Reads a text-only element. Zaleca się jednak użycie metody ReadElementContentAsString(), ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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

Tekst zawarty w elemencie, który został odczytany.The text contained in the element that was read. Pusty ciąg, jeśli element jest pusty.An empty string if the element is empty.

Wyjątki

Następny węzeł zawartości nie jest tagiem początkowym; lub znaleziony element nie zawiera prostej wartości tekstowej.The next content node is not a start tag; or the element found does not contain a simple text value.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Uwagi

Zalecamy użycie metody ReadElementContentAsString() w celu odczytania elementu tekstowego.We recommend that you use the ReadElementContentAsString() method to read a text element.

ReadElementString(String)

Sprawdza, czy właściwość Name elementu znalezionych pasuje do podanego ciągu przed odczytaniem elementu tekstowego.Checks that the Name property of the element found matches the given string before reading a text-only element. Zaleca się jednak użycie metody ReadElementContentAsString(), ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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.The name to check.

Zwraca

Tekst zawarty w elemencie, który został odczytany.The text contained in the element that was read. Pusty ciąg, jeśli element jest pusty.An empty string if the element is empty.

Wyjątki

Jeśli następny węzeł zawartości nie jest tagiem początkowym; Jeśli element Name nie jest zgodny z podanym argumentem; lub jeśli znaleziony element nie zawiera prostej wartości tekstowej.If the next content node is not a start tag; if the element Name does not match the given argument; or if the element found does not contain a simple text value.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Uwagi

Zalecamy użycie metody ReadElementContentAsString() w celu odczytania elementu tekstowego.We recommend that you use the ReadElementContentAsString() method to read a text element.

ReadElementString(String, String)

Sprawdza, czy właściwości LocalName i NamespaceURI elementu znalezione są zgodne z podanymi ciągami przed odczytem elementu tekstowego.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. Zaleca się jednak użycie metody ReadElementContentAsString(String, String), ponieważ zapewnia ona bardziej prosty sposób obsługi tej operacji.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

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.The local name to check.

ns
String

Identyfikator URI przestrzeni nazw do sprawdzenia.The namespace URI to check.

Zwraca

Tekst zawarty w elemencie, który został odczytany.The text contained in the element that was read. Pusty ciąg, jeśli element jest pusty.An empty string if the element is empty.

Wyjątki

Jeśli następny węzeł zawartości nie jest tagiem początkowym; Jeśli element LocalName lub NamespaceURI nie jest zgodny z podanym argumentem; lub jeśli znaleziony element nie zawiera prostej wartości tekstowej.If the next content node is not a start tag; if the element LocalName or NamespaceURI do not match the given arguments; or if the element found does not contain a simple text value.

Metoda XmlReader została wywołana przed ukończeniem poprzedniej operacji asynchronicznej.An XmlReader method was called before a previous asynchronous operation finished. W takim przypadku InvalidOperationException jest generowany z komunikatem "asynchroniczna operacja jest już w toku".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Uwagi

Zalecamy użycie metody ReadElementContentAsString(String, String) w celu odczytania elementu tekstowego.We recommend that you use the ReadElementContentAsString(String, String) method to read a text element.

Dotyczy