XmlObjectSerializer.IsStartObject メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
シリアライザーがオブジェクトを読み取ることができるかどうかを示す値を取得します。
オーバーロード
| 名前 | 説明 |
|---|---|
| IsStartObject(XmlDictionaryReader) |
読み取り可能な XML 要素の上に XmlDictionaryReader を配置するかどうかを指定する値を取得します。 |
| IsStartObject(XmlReader) |
読み取り可能な XML 要素の上に XmlReader を配置するかどうかを指定する値を取得します。 |
注釈
このメソッドは、リーダーが読み取る要素に配置されているかどうかをチェックし、要素が XML ストリームまたはドキュメント内で見つかったオブジェクトの最上位要素である場合は、 true を返します。
trueを返すには、見つかった要素に予期される名前が必要です。 予想される実際の要素名は、シリアライザーの実装によって異なります。
DataContractSerializerでは、開始要素は拡張クラスのコンストラクターで指定されます。 例については、 DataContractSerializer クラスのコンストラクターを参照してください。
IsStartObject(XmlDictionaryReader)
読み取り可能な XML 要素の上に XmlDictionaryReader を配置するかどうかを指定する値を取得します。
public:
abstract bool IsStartObject(System::Xml::XmlDictionaryReader ^ reader);public abstract bool IsStartObject(System.Xml.XmlDictionaryReader reader);abstract member IsStartObject : System.Xml.XmlDictionaryReader -> boolPublic MustOverride Function IsStartObject (reader As XmlDictionaryReader) As Booleanパラメーター
- reader
- XmlDictionaryReader
XML ストリームまたはドキュメントの読み取りに使用する XmlDictionaryReader 。
返品
true リーダーがデータを読み取ることができる場合。それ以外の場合は false。
注釈
このメソッドは、リーダーが読み取る要素に配置されているかどうかをチェックし、要素が XML ストリームまたはドキュメント内で見つかったオブジェクトの最上位要素であるかどうかを true 返します。
XmlObjectSerializer実装は、trueを返すタイミングを決定します。 実装では、要素上に配置されていることを確認したり、予期される要素名を探したりする場合があります。
XmlObjectSerializerの実装の 1 つであるDataContractSerializerは、要素に配置されていることを確認し、現在逆シリアル化されている型の最上位レベルの名前が要素名であることを確認します。
必要に応じて、 ReadObject メソッドを使用して XML コンテンツを読み取る前に、XML ストリーム内の追加の属性を最上位レベルの要素に配置して読み取ることができます。
適用対象
IsStartObject(XmlReader)
読み取り可能な XML 要素の上に XmlReader を配置するかどうかを指定する値を取得します。
public:
virtual bool IsStartObject(System::Xml::XmlReader ^ reader);public virtual bool IsStartObject(System.Xml.XmlReader reader);abstract member IsStartObject : System.Xml.XmlReader -> bool
override this.IsStartObject : System.Xml.XmlReader -> boolPublic Overridable Function IsStartObject (reader As XmlReader) As Booleanパラメーター
返品
true リーダーが開始要素の上に配置されている場合。それ以外の場合は false。
注釈
このメソッドは、リーダーが読み取る要素に配置されているかどうかをチェックし、要素が XML ストリームまたはドキュメント内で見つかったオブジェクトの最上位要素である場合は、 true を返します。
trueを返すには、見つかった要素に予期される名前が必要です。 予想される実際の要素名は、シリアライザーの実装によって異なります。
DataContractSerializerでは、開始要素は拡張クラスのコンストラクターで指定されます。 例については、 DataContractSerializer クラスのコンストラクターを参照してください。