DataRepeater.ItemValueNeeded イベント

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

更新 : 2007 年 11 月

VirtualMode プロパティが True に設定されており、DataRepeaterItem の子コントロールの新しい値が必要な場合に発生します。

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

構文

'宣言
Public Event ItemValueNeeded As DataRepeaterItemValueEventHandler
'使用
Dim instance As DataRepeater
Dim handler As DataRepeaterItemValueEventHandler

AddHandler instance.ItemValueNeeded, handler

public event DataRepeaterItemValueEventHandler ItemValueNeeded

public:
 event DataRepeaterItemValueEventHandler^ ItemValueNeeded {
    void add (DataRepeaterItemValueEventHandler^ value);
    void remove (DataRepeaterItemValueEventHandler^ value);
}

JScript では、イベントは使用できません。

解説

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

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;
        }
    }
}