DataRepeaterItemValueEventArgs 類別

發行項
10/31/2012

為 ItemValueNeeded 和 ItemValuePushed 事件提供資料。

繼承階層架構

System.Object
System.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 事件。它會假設您有DataRepeater控制項而來DataRepeater1有其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;
        }
    }
}