ListBox.LoadPostData メソッド

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

ListBox.LoadPostData メソッド

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

リスト コントロールのポストされた内容が前回ポストされた内容と異なる場合に、その内容を読み込みます。

名前空間: 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 をインデックス化するために使用される、コントロールのキー識別子。

postCollection

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

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

解説

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

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

LoadPostData メソッドがコントロールに true を返すと、ASP.NET ページ フレームワークがこのコントロールの 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

参照

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