XmlReader.ReadElementContentAs Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Odczytuje bieżący element i zwraca zawartość jako obiekt określonego typu.

Przeciążenia

ReadElementContentAs(Type, IXmlNamespaceResolver)	Odczytuje zawartość elementu jako żądany typ.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Sprawdza, czy określona lokalna nazwa i identyfikator URI przestrzeni nazw są zgodne z bieżącym elementem, a następnie odczytuje zawartość elementu jako żądany typ.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Odczytuje zawartość elementu jako żądany typ.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parametry

returnType: Type

Typ wartości, która ma zostać zwrócona.

Uwaga Po wydaniu .NET Framework 3.5 wartość parametru returnType może być teraz typemDateTimeOffset.

namespaceResolver: IXmlNamespaceResolver

IXmlNamespaceResolver Obiekt używany do rozpoznawania wszelkich prefiksów przestrzeni nazw związanych z konwersją typu.

Zwraca

Object

Zawartość elementu przekonwertowana na żądany typ obiektu.

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 żądany typ.

ArgumentNullException

Metoda jest wywoływana z null argumentami.

OverflowException

Przeczytaj Decimal.MaxValue.

Przykłady

W poniższym przykładzie użyto ReadElementContentAs metody do odczytania zawartości węzła date .

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
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 ReadElementContentAsAsync.

Dotyczy

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Sprawdza, czy określona lokalna nazwa i identyfikator URI przestrzeni nazw są zgodne z bieżącym elementem, a następnie odczytuje zawartość elementu jako żądany typ.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs (Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parametry

returnType: Type

Typ wartości do zwrócenia.

Uwaga Po wydaniu .NET Framework 3.5 wartość parametru returnType może być teraz typemDateTimeOffset.

namespaceResolver: IXmlNamespaceResolver

Obiekt IXmlNamespaceResolver używany do rozpoznawania wszelkich prefiksów przestrzeni nazw związanych z konwersją typu.

localName: String

Lokalna nazwa elementu.

namespaceURI: String

Identyfikator URI przestrzeni nazw elementu.

Zwraca

Object

Zawartość elementu przekonwertowana na żądany obiekt wpisany.

Wyjątki

InvalidOperationException

Element XmlReader nie jest umieszczony na elemecie .

-lub-

XmlException

Bieżący element zawiera elementy podrzędne.

-lub-

Nie można przekonwertować zawartości elementu na żądany typ.

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.

OverflowException

Przeczytaj Decimal.MaxValue.

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.

Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader i zalecenia W3C XML Schema Part 2: Datatypes (Schemat XML W3C— część 2: zalecenia dotyczące typów danych ).

Dotyczy

Udostępnij za pośrednictwem

XmlReader.ReadElementContentAs Metoda

Definicja

Przeciążenia

ReadElementContentAs(Type, IXmlNamespaceResolver)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Dodatkowe zasoby