DataRepeaterItemValueEventArgs 類別

發行項
05/16/2015

為 ItemValueNeeded 和 ItemValuePushed 事件提供資料。

繼承階層架構

Object
EventArgs
Microsoft.VisualBasic.PowerPacks.DataRepeaterItemValueEventArgs

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

語法

'宣告
Public Class DataRepeaterItemValueEventArgs _
    Inherits EventArgs

public class DataRepeaterItemValueEventArgs : EventArgs

public ref class DataRepeaterItemValueEventArgs : public EventArgs

type DataRepeaterItemValueEventArgs =  
    class 
        inherit EventArgs 
    end

public class DataRepeaterItemValueEventArgs extends EventArgs

DataRepeaterItemValueEventArgs 類型會公開下列成員。

建構函式

	名稱	描述
	DataRepeaterItemValueEventArgs	初始化 DataRepeaterItemValueEventArgs 類別的新執行個體。

回頁首

屬性

	名稱	描述
	Control	取得 DataRepeaterItem 的子控制項，這個物件正在引發 ItemValueNeeded 或 ItemValuePushed 事件。
	ItemIndex	取得 DataRepeaterItem 的索引，這個物件包含引發 ItemValueNeeded 或 ItemValuePushed 事件的控制項。
	PropertyName	取得引發 ItemValueNeeded 或 ItemValuePushed 事件之控制項的資料繫結屬性的名稱。
	Value	取得已變更而引發 ItemValueNeeded 或 ItemValuePushed 事件的屬性值。

回頁首

方法

	名稱	描述
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	在記憶體回收開始前，允許物件嘗試釋放資源，並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	ToString	傳回代表目前物件的字串。 (繼承自 Object)。

回頁首

備註

在虛擬模式下，請使用 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;
        }
    }
}