XmlReader.ReadContentAsLong メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の位置にあるテキスト コンテンツを 64 ビット符号付き整数として読み取ります。
public:
virtual long ReadContentAsLong();
public virtual long ReadContentAsLong();
abstract member ReadContentAsLong : unit -> int64
override this.ReadContentAsLong : unit -> int64
Public Overridable Function ReadContentAsLong () As Long
返品
64 ビット符号付き整数としてのテキスト コンテンツ。
例外
試行されたキャストが無効です。
文字列形式が無効です。
前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。
注釈
このメソッドは、テキスト、空白、重要な空白、および CDATA セクションを連結し、コメントや処理命令をスキップします。 エンティティ参照は自動的に解決されます。
コンテンツが xsd:long型指定されている場合、リーダーはボックス化されていない 64 ビット符号付き整数を返します。 コンテンツが xsd:long型指定されていない場合、リーダーは W3C XML スキーマ パート 2: Datatypes に関する推奨事項で定義されている規則に従って、64 ビット符号付き整数への変換を試みます。
次の表では、このメソッドが各ノードの種類を処理する方法について説明します。
| XmlNodeType | 値を返す | 閲覧者の動作 |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
要求された型に変換されたテキスト、CDATA、空白、および重要な空白ノードの連結されたコンテンツ。 | 次の開始要素または終了要素タグに移動します。 エンティティ参照は自動的に展開されます。 |
Attribute |
属性値の XmlConvert.ToXxx と同じです。 |
リーダーは現在の位置に残ります |
CommentProcessingInstruction |
処理命令 (PI) またはコメントを無視し、PI またはコメントに続く連結テキスト コンテンツを読み取ります。 | 次の開始要素または終了要素タグに移動します。 エンティティ参照は自動的に展開されます。 |
EndElement |
空の文字列。 | リーダーは現在の位置に残ります。 |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
InvalidOperationExceptionがスローされます。 | 未定義ですが、通常、リーダーは現在の位置に残ります。 |
詳細については、XmlReader のリファレンス ページの「解説」を参照してください。