XmlReader.ReadElementString メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
単純なテキストのみの要素を読み取ります。 ただし、ReadElementContentAsString メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。
| ReadElementString() |
テキストのみの要素を読みます。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。 |
| ReadElementString(String) |
テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。 |
| ReadElementString(String, String) |
テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString(String, String) メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。 |
このメソッドを使用 ReadElementContentAsString してテキスト要素を読み取うことをお勧めします。
ReadElementString()
テキストのみの要素を読みます。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。
public:
virtual System::String ^ ReadElementString();public virtual string ReadElementString ();abstract member ReadElementString : unit -> string
override this.ReadElementString : unit -> stringPublic Overridable Function ReadElementString () As String戻り値
読み取られた要素内に格納されているテキスト。 要素が空の場合は、空の文字列。
例外
次のコンテンツ ノードが開始タグでないか、見つかった要素に単純なテキスト値が格納されていません。
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
注釈
このメソッドを使用 ReadElementContentAsString() してテキスト要素を読み取うことをお勧めします。
適用対象
.NET 7 およびその他のバージョン
| 製品 | バージョン |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 2.0, 2.1 |
ReadElementString(String)
テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。
public:
virtual System::String ^ ReadElementString(System::String ^ name);public virtual string ReadElementString (string name);abstract member ReadElementString : string -> string
override this.ReadElementString : string -> stringPublic Overridable Function ReadElementString (name As String) As Stringパラメーター
- name
- String
確認対象の名前。
戻り値
読み取られた要素内に格納されているテキスト。 要素が空の場合は、空の文字列。
例外
次のコンテンツ ノードが開始タグでない、要素 Name が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
注釈
このメソッドを使用 ReadElementContentAsString() してテキスト要素を読み取うことをお勧めします。
適用対象
.NET 7 およびその他のバージョン
| 製品 | バージョン |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 2.0, 2.1 |
ReadElementString(String, String)
テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString(String, String) メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。
public:
virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);public virtual string ReadElementString (string localname, string ns);abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> stringPublic Overridable Function ReadElementString (localname As String, ns As String) As Stringパラメーター
- localname
- String
確認対象のローカル名。
- ns
- String
確認対象の名前空間 URI。
戻り値
読み取られた要素内に格納されているテキスト。 要素が空の場合は、空の文字列。
例外
次のコンテンツ ノードが開始タグでない、要素 LocalName または NamespaceURI が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
注釈
このメソッドを使用 ReadElementContentAsString(String, String) してテキスト要素を読み取うことをお勧めします。
適用対象
.NET 7 およびその他のバージョン
| 製品 | バージョン |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 2.0, 2.1 |