XmlReader.ReadElementString メソッド (String, String)
テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。
Overloads Public Overridable Function ReadElementString( _
ByVal localname As String, _ ByVal ns As String _) As String
[C#]
public virtual string ReadElementString(stringlocalname,stringns);
[C++]
public: virtual String* ReadElementString(String* localname,String* ns);
[JScript]
public function ReadElementString(
localname : String,ns : String) : String;
パラメータ
- localname
確認対象のローカル名。 - ns
確認対象の名前空間 URI。
戻り値
読み取られた要素内に格納されているテキスト。要素が空 (<item></item>
または <item/>
) の場合は、空の文字列。
例外
例外の種類 | 条件 |
---|---|
XmlException | 次のコンテンツ ノードが開始タグでない、要素 LocalName または NamespaceURI が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。 |
解説
これは、単純なテキストだけの要素を読み取るためのヘルパ メソッドです。 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 オーバーロードの一覧