次の方法で共有


XmlReader.ReadElementString メソッド (String)

テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。

Overloads Public Overridable Function ReadElementString( _
   ByVal name As String _) As String
[C#]
public virtual string ReadElementString(stringname);
[C++]
public: virtual String* ReadElementString(String* name);
[JScript]
public function ReadElementString(
   name : String) : String;

パラメータ

  • name
    確認対象の名前。

戻り値

読み取られた要素内に格納されているテキスト。要素が空 (<item></item> または <item/>) の場合は、空の文字列。

例外

例外の種類 条件
XmlException 次のコンテンツ ノードが開始タグでない、要素 Name が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。

解説

これは、単純なテキストだけの要素を読み取るためのヘルパ メソッドです。 MoveToContent を呼び出して、次のコンテンツ ノードを検索してから、その値を単純文字列として解析します。

XML、 <name>Arlene Huff</name>ReadElementString を使用すると、要素が処理され、文字列 Arlene Huff が返されます。

このメソッドは name 要素内のマークアップ (子要素、コメント、処理命令など) を処理できませんが、複数の隣接したテキスト ブロックと CDATA ブロックを連結できます。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

参照

XmlReader クラス | XmlReader メンバ | System.Xml 名前空間 | XmlReader.ReadElementString オーバーロードの一覧