DataRepeaterItemValueEventArgs.Value プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

変更されて ItemValueNeeded イベントまたは ItemValuePushed イベントを発生させたプロパティ値を取得します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public Property Value As Object
'使用
Dim instance As DataRepeaterItemValueEventArgs
Dim value As Object

value = instance.Value

instance.Value = value

public Object Value { get; set; }

public:
property Object^ Value {
    Object^ get ();
    void set (Object^ value);
}

public function get Value () : Object
public function set Value (value : Object)

プロパティ値

型 : System.Object

プロパティに割り当てる値、またはデータストアに保存する値。

解説

仮想モードでは、ItemValueNeeded イベントを使用して、DataRepeaterItem が表示されているとき、または新しい項目が追加されるときに、データストアの値を使用して ItemTemplate の子コントロールを設定できます。

子コントロールの値への変更をデータストアに保存するには、ItemValuePushed イベントを使用します。

VirtualMode プロパティが False に設定されている場合、これらのイベントは発生しません。

例

ItemValueNeeded イベントを処理する方法を次の例に示します。この例は、DataRepeater1 という名前の DataRepeater コントロールが存在し、その VirtualMode プロパティが True. に設定されていることを前提としています。コードは、次の例のようになります。ここでは、Employees という名前のデータソースを使用します。

Private Sub DataRepeater1_ItemValueNeeded(ByVal sender As Object, _
 ByVal e As  _
 Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs) _
 Handles DataRepeater1.ItemValueNeeded
    If e.ItemIndex < Employees.Count Then
        Select Case e.Control.Name
            Case "txtFirstName"
                e.Value = Employees.Item(e.ItemIndex + 1).firstName
            Case "txtLastName"
                e.Value = Employees.Item(e.ItemIndex + 1).lastName
        End Select
    End If
End Sub

private void dataRepeater1_ItemValueNeeded(object sender, Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs e)
{
    if (e.ItemIndex < Employees.Count)
    {
        switch (e.Control.Name)
        {
            case "txtFirstName":
                e.Value = Employees[e.ItemIndex + 1].firstName;
                break;
            case "txtLastName":
                e.Value = Employees[e.ItemIndex + 1].lastName;
                break;
        }
    }
}