XmlReader.ReadElementContentAsString メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。
オーバーロード
| ReadElementContentAsString(String, String) |
指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを String オブジェクトとして返します。 |
| ReadElementContentAsString() |
現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。 |
ReadElementContentAsString(String, String)
- ソース:
- XmlReader.cs
- ソース:
- XmlReader.cs
- ソース:
- XmlReader.cs
指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを String オブジェクトとして返します。
public:
virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);public virtual string ReadElementContentAsString (string localName, string namespaceURI);abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> stringPublic Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As Stringパラメーター
- localName
- String
要素のローカル名。
- namespaceURI
- String
要素の名前空間 URI。
戻り値
コンテンツの要素、Stringオブジェクト。
例外
XmlReader が要素に配置されません。
- または -
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
引数に null を渡してメソッドが呼び出されました。
指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。
例
次の例では、 要素を stringValue 読み取り、テキスト コンテンツを返します (コメントと処理命令は無視します)。
using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
reader.ReadToFollowing("stringValue");
Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
reader.ReadToFollowing("stringValue")
Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
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>
注釈
このメソッドは、要素の内容である開始タグを読み取り、リーダーを終了要素タグの後に移動します。 エンティティを展開し、処理命令とコメントを無視します。 要素には単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。
詳細については、リファレンス ページの XmlReader 「解説」セクションと W3C XML スキーマ パート 2: データ型に関する推奨事項を 参照してください。
適用対象
ReadElementContentAsString()
- ソース:
- XmlReader.cs
- ソース:
- XmlReader.cs
- ソース:
- XmlReader.cs
現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。
public:
virtual System::String ^ ReadElementContentAsString();public virtual string ReadElementContentAsString ();abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> stringPublic Overridable Function ReadElementContentAsString () As String戻り値
コンテンツの要素、Stringオブジェクト。
例外
XmlReader が要素に配置されません。
- または -
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
引数に null を渡してメソッドが呼び出されました。
例
次の例では、 要素を stringValue 読み取り、テキスト コンテンツを返します (コメントと処理命令は無視します)。
using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
reader.ReadToFollowing("stringValue");
Console.WriteLine(reader.ReadElementContentAsString());
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
reader.ReadToFollowing("stringValue")
Console.WriteLine(reader.ReadElementContentAsString())
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>
注釈
このメソッドは、要素の内容である開始タグを読み取り、リーダーを終了要素タグの後に移動します。 エンティティを展開し、処理命令とコメントを無視します。 要素には単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。
詳細については、リファレンス ページの XmlReader 「解説」セクションと W3C XML スキーマ パート 2: データ型に関する推奨事項を 参照してください。
このメソッドの非同期バージョンについては、「」を参照してください ReadElementContentAsStringAsync。
適用対象
.NET