XmlReader.ReadElementContentAsLong メソッド

定義

名前空間:
System.Xml
アセンブリ:
System.Xml.dll, System.Xml.ReaderWriter.dll
アセンブリ:
netstandard.dll, System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.ReaderWriter.dll
アセンブリ:
System.Xml.dll
アセンブリ:
netstandard.dll

現在の要素を読み取り、内容を 64 ビット符号付き整数として返します。

オーバーロード

名前 説明
ReadElementContentAsLong()

現在の要素を読み取り、内容を 64 ビット符号付き整数として返します。
ReadElementContentAsLong(String, String)

指定したローカル名と名前空間 URI が現在の要素の URI と一致することを確認し、現在の要素を読み取り、内容を 64 ビット符号付き整数として返します。

ReadElementContentAsLong()

ソース:
XmlReader.cs
ソース:
XmlReader.cs
ソース:
XmlReader.cs
ソース:
XmlReader.cs
ソース:
XmlReader.cs

現在の要素を読み取り、内容を 64 ビット符号付き整数として返します。

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

返品

Int64

64 ビット符号付き整数としての要素の内容。

例外

InvalidOperationException

XmlReaderは要素上に配置されません。

-又は-

前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。

XmlException

現在の要素には子要素が含まれています。

-又は-

要素の内容を 64 ビット符号付き整数に変換することはできません。

ArgumentNullException

このメソッドは、 null 引数を使用して呼び出されます。

例

次の例では、 ReadElementContentAsLong メソッドを使用して、 longValue 要素の内容を読み取います。

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

この例では、 dataFile.xml ファイルを入力として使用します。

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

注釈

このメソッドは、開始タグ(要素の内容)を読み取り、リーダーを終了要素タグの後に移動します。 エンティティが展開され、処理命令とコメントは無視されます。 要素には単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。

コンテンツが xsd:long型指定されている場合、リーダーはボックス化されていない 64 ビット符号付き整数を返します。 コンテンツが xsd:long型指定されていない場合、リーダーは W3C XML スキーマ パート 2: Datatypes に関する推奨事項で定義されている規則に従って、64 ビット符号付き整数への変換を試みます。

詳細については、XmlReader のリファレンス ページの「解説」を参照してください。

適用対象

ReadElementContentAsLong(String, String)

ソース:
XmlReader.cs
ソース:
XmlReader.cs
ソース:
XmlReader.cs
ソース:
XmlReader.cs
ソース:
XmlReader.cs

指定したローカル名と名前空間 URI が現在の要素の URI と一致することを確認し、現在の要素を読み取り、内容を 64 ビット符号付き整数として返します。

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

パラメーター

localName
String

要素のローカル名。

namespaceURI
String

要素の名前空間 URI。

返品

Int64

64 ビット符号付き整数としての要素の内容。

例外

InvalidOperationException

XmlReaderは要素上に配置されません。

-又は-

前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。

XmlException

現在の要素には子要素が含まれています。

-又は-

要素の内容を 64 ビット符号付き整数に変換することはできません。

ArgumentNullException

このメソッドは、 null 引数を使用して呼び出されます。

ArgumentException

指定したローカル名と名前空間 URI が、読み取られる現在の要素の URI と一致しません。

注釈

このメソッドは、開始タグ(要素の内容)を読み取り、リーダーを終了要素タグの後に移動します。 エンティティが展開され、処理命令とコメントは無視されます。 要素には単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。

コンテンツが xsd:long型指定されている場合、リーダーはボックス化されていない 64 ビット符号付き整数を返します。 コンテンツが xsd:long型指定されていない場合、リーダーは W3C XML スキーマ パート 2: Datatypes に関する推奨事項で定義されている規則に従って、64 ビット符号付き整数への変換を試みます。

詳細については、XmlReader のリファレンス ページの「解説」を参照してください。

適用対象