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 クラスのコンストラクターを参照してください。
適用対象
.NET