DataRepeaterItemValueEventArgs.PropertyName 屬性

發行項
05/16/2015

取得引發 ItemValueNeeded 或 ItemValuePushed 事件之控制項的資料繫結屬性的名稱。

命名空間： Microsoft.VisualBasic.PowerPacks
組件： Microsoft.VisualBasic.PowerPacks.Vs (在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

語法

'宣告
Public ReadOnly Property PropertyName As String

public string PropertyName { get; }

public:
property String^ PropertyName {
    String^ get ();
}

member PropertyName : string with get

function get PropertyName () : String

屬性值

類型：String
屬性的名稱。

備註

在虛擬模式下，請使用 ItemValueNeeded 事件填入 ItemTemplate 的子控制項的值從資料存放區，當 DataRepeaterItem 時，或當加入新項目時。

使用 ItemValuePushed 事件儲存子控制項的值變更為您的資料存放區。

當 VirtualMode 屬性設定為 False時，這些事件不會引發事件。

範例

在下列程式碼中，示範了如何處理 ItemValueNeeded 事件。它假設您有一份表單，其 VirtualMode 屬性設定為 True的程式碼與下列範例類似，對資料來源名稱為 Employees的 DataRepeater 控制項的具名 DataRepeater1 。

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