Udostępnij za pośrednictwem


XmlReader.ReadElementContentAsString Metoda

Definicja

Odczytuje bieżący element i zwraca zawartość jako String obiekt.

Przeciążenia

ReadElementContentAsString(String, String)

Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem String , a następnie odczytuje bieżący element i zwraca zawartość jako obiekt.

ReadElementContentAsString()

Odczytuje bieżący element i zwraca zawartość jako String obiekt.

ReadElementContentAsString(String, String)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Sprawdza, czy określona nazwa lokalna i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem String , a następnie odczytuje bieżący element i zwraca zawartość jako obiekt.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString (string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Parametry

localName
String

Lokalna nazwa elementu.

namespaceURI
String

Identyfikator URI przestrzeni nazw elementu.

Zwraca

Zawartość elementu jako String obiekt.

Wyjątki

Element XmlReader nie jest umieszczony na elemecie.

-lub-

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".

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na String obiekt.

Metoda jest wywoływana z null argumentami.

Określona nazwa lokalna i identyfikator URI przestrzeni nazw nie są zgodne z bieżącym elementem odczytywanym.

Przykłady

Poniższy przykład odczytuje stringValue element i zwraca zawartość tekstowa (ignorując instrukcję komentarza i przetwarzania).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

W przykładzie użyto dataFile.xml pliku jako danych wejściowych.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Uwagi

Ta metoda odczytuje tag startowy, zawartość elementu i przenosi czytnik obok tagu elementu końcowego. Rozszerza jednostki i ignoruje instrukcje przetwarzania i komentarze. Element może zawierać tylko prostą zawartość. Oznacza to, że nie może mieć elementów podrzędnych.

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 ).

Dotyczy

ReadElementContentAsString()

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Odczytuje bieżący element i zwraca zawartość jako String obiekt.

public:
 virtual System::String ^ ReadElementContentAsString();
public virtual string ReadElementContentAsString ();
abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string
Public Overridable Function ReadElementContentAsString () As String

Zwraca

Zawartość elementu jako String obiekt.

Wyjątki

Element XmlReader nie jest umieszczony na elemecie.

-lub-

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".

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na String obiekt.

Metoda jest wywoływana z null argumentami.

Przykłady

Poniższy przykład odczytuje stringValue element i zwraca zawartość tekstowa (ignorując instrukcję komentarza i przetwarzania).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

W przykładzie użyto dataFile.xml pliku jako danych wejściowych.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Uwagi

Ta metoda odczytuje tag startowy, zawartość elementu i przenosi czytnik obok tagu elementu końcowego. Rozszerza jednostki i ignoruje instrukcje przetwarzania i komentarze. Element może zawierać tylko prostą zawartość. Oznacza to, że nie może mieć elementów podrzędnych.

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 ReadElementContentAsStringAsync.

Dotyczy