XmlReader.ReadElementContentAsLong Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xml
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll

Odczytuje bieżący element i zwraca zawartość jako 64-bitową liczbę całkowitą ze znakiem.

Przeciążenia

ReadElementContentAsLong()

Odczytuje bieżący element i zwraca zawartość jako 64-bitową liczbę całkowitą ze znakiem.
ReadElementContentAsLong(String, String)

Sprawdza, czy określona lokalna nazwa i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem, a następnie odczytuje bieżący element i zwraca zawartość jako 64-bitową liczbę całkowitą ze znakiem.

ReadElementContentAsLong()

Odczytuje bieżący element i zwraca zawartość jako 64-bitową liczbę całkowitą ze znakiem.

public:
 virtual long ReadElementContentAsLong();
public virtual long ReadElementContentAsLong ();
abstract member ReadElementContentAsLong : unit -> int64
override this.ReadElementContentAsLong : unit -> int64
Public Overridable Function ReadElementContentAsLong () As Long

Zwraca

Int64

Zawartość elementu jako 64-bitowa liczba całkowita ze znakiem.

Wyjątki

InvalidOperationException

Element XmlReader nie jest umieszczony na elemecie .

-lub-

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

XmlException

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na 64-bitową liczbę całkowitą ze znakiem.

ArgumentNullException

Metoda jest wywoływana z null argumentami.

Przykłady

W poniższym przykładzie użyto ReadElementContentAsLong metody do odczytania zawartości longValue elementu.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("longValue");
     long number = reader.ReadElementContentAsLong();
     // Do some processing with the number object.
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("longValue")
  Dim number As Long = reader.ReadElementContentAsLong()
  ' Do some processing with the number object.
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 przetwarzanie instrukcji i komentarzy. Element może zawierać tylko prostą zawartość. Oznacza to, że nie może mieć elementów podrzędnych.

Jeśli zawartość jest typowana xsd:long, czytnik zwraca bez skrzynki 64-bitowej liczbę całkowitą ze znakiem. Jeśli zawartość nie jest wpisywana xsd:long, czytelnik próbuje przekonwertować ją na 64-bitową liczbę całkowitą ze znakiem zgodnie z regułami zdefiniowanymi przez zalecenie schematu XML W3C — część 2: zalecenia dotyczące typów danych .

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Dotyczy

ReadElementContentAsLong(String, String)

Sprawdza, czy określona lokalna nazwa i identyfikator URI przestrzeni nazw jest zgodna z bieżącym elementem, a następnie odczytuje bieżący element i zwraca zawartość jako 64-bitową liczbę całkowitą ze znakiem.

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

Parametry

localName
String

Lokalna nazwa elementu.

namespaceURI
String

Identyfikator URI przestrzeni nazw elementu.

Zwraca

Int64

Zawartość elementu jako 64-bitowa liczba całkowita ze znakiem.

Wyjątki

InvalidOperationException

Element XmlReader nie jest umieszczony na elemecie .

-lub-

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

XmlException

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na 64-bitową liczbę całkowitą ze znakiem.

ArgumentNullException

Metoda jest wywoływana z null argumentami.

ArgumentException

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

Uwagi

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

Jeśli zawartość jest typowana xsd:long, czytnik zwraca bez skrzynki 64-bitowej liczbę całkowitą ze znakiem. Jeśli zawartość nie jest wpisywana xsd:long, czytelnik próbuje przekonwertować ją na 64-bitową liczbę całkowitą ze znakiem zgodnie z regułami zdefiniowanymi przez zalecenie schematu XML W3C — część 2: zalecenia dotyczące typów danych .

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Dotyczy