StateBag.Item[String] プロパティ

定義

StateBag オブジェクト内に格納された項目の値を取得または設定します。Gets or sets the value of an item stored in the StateBag object.

public:
 property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ key); void set(System::String ^ key, System::Object ^ value); };
public object this[string key] { get; set; }
member this.Item(string) : obj with get, set
Default Public Property Item(key As String) As Object

パラメーター

key
String

項目のキー。The key for the item.

プロパティ値

Object

StateBag オブジェクト内の指定した項目。The specified item in the StateBag object.

名前と値をキー/値ペアとしてプロパティに保存するプロパティのコード例を次に示し Control.ViewState ます。The following code example demonstrates a property that saves its name and value as a key/value pair to the Control.ViewState property. ViewStateプロパティは、クラスのインスタンスです StateBagThe ViewState property is an instance of the StateBag class.

// Add property values to view state with set;
// retrieve them from view state with get.
public String Text
{
    get 
    { 
        object o = ViewState["Text"]; 
        return (o == null)? String.Empty : (string)o;
    }

    set
    {
        ViewState["Text"] = value;
    }
}

' Add property values to view state with set; 
' retrieve them from view state with get.
Public Property [Text]() As String
    Get
        Dim o As Object = ViewState("Text")
        If (IsNothing(o)) Then
            Return String.Empty
        Else
            Return CStr(o)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("Text") = value
    End Set
End Property

注釈

このメンバーを使用することは、コントロールまたはページのビューステートの値を保存および取得する最も簡単な方法です。Using this member is the simplest way to save and retrieve view-state values for a control or a page.

このプロパティを設定するときに、項目がオブジェクトにまだ格納されていない場合は、 StateBag そのキーと値のペアがコレクションに追加されます。If an item is not already stored in the StateBag object when you set this property, its key/value pair is added to the collection. このプロパティをに設定すると、 null TrackViewState メソッドが項目に対して呼び出される前に、オブジェクトから削除され StateBag ます。If you set this property to null before the TrackViewState method is called on an item, it is removed from the StateBag object. それ以外の場合、このプロパティをに設定すると、 null 項目のビューステートの追跡を許可するために、キーが保存されます。Otherwise, when you set this property to null the key is saved to allow tracking of the item's view state.

適用対象

こちらもご覧ください