CheckBoxList.LoadPostData メソッド

.NET Framework クラス ライブラリ リファレンス

CheckBoxList.LoadPostData メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

CheckBoxList コントロールのポストされたデータを処理します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 LoadPostData ( _
    postDataKey As String, _
    postCollection As NameValueCollection _
) As Boolean

Visual Basic (使用法)

Dim postDataKey As String
Dim postCollection As NameValueCollection
Dim returnValue As Boolean

returnValue = Me.LoadPostData(postDataKey, postCollection)

C#

protected virtual bool LoadPostData (
    string postDataKey,
    NameValueCollection postCollection
)

C++

protected:
virtual bool LoadPostData (
    String^ postDataKey, 
    NameValueCollection^ postCollection
)

J#

protected boolean LoadPostData (
    String postDataKey, 
    NameValueCollection postCollection
)

JScript

protected function LoadPostData (
    postDataKey : String, 
    postCollection : NameValueCollection
) : boolean

パラメータ

postDataKey

postCollection パラメータで指定された System.Collections.Specialized.NameValueCollection をインデックス化するために使用される、コントロールのキー識別子。

postCollection

コントロール ID によってインデックス化された値の情報を格納している NameValueCollection。

戻り値
CheckBoxList の状態が前回ポストされた内容と異なる場合は true。それ以外の場合は false。

解説

LoadPostData メソッドは、カスタム コントロールを CheckBoxList クラスから派生させる場合に、主にコントロールの開発者によって使用されます。

LoadPostData メソッドは、CheckBoxList コントロールの状態が変更されたかどうかを示します。つまり、コントロールの各リスト項目の Selected の値が、前回ポストされた値と同じかどうかを確認します。ユーザーがコントロールの項目を選択またはクリアすると、CheckBoxList コントロールの Items コレクションの対応する ListItem オブジェクトの Selected プロパティ値が変更されます。コントロールの同じリスト項目が選択されている場合や、CheckBoxList が無効な場合は、LoadPostData は false を返します。

LoadPostData メソッドがコントロールに true を返すと、ページ フレームワークがこのコントロールの RaisePostDataChangedEvent メソッドを呼び出します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CheckBoxList クラス
CheckBoxList メンバ
System.Web.UI.WebControls 名前空間
LoadPostData
OnSelectedIndexChanged
その他の技術情報
CheckBox Web サーバー コントロールおよび CheckBoxList Web サーバー コントロール