DataRepeater.ItemValueNeeded 事件

發行項
08/21/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 且其 VirtualMode 屬性設定為 True 的 DataRepeater 控制項，而且您也擁有名為 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;
        }
    }
}