DataRepeaterItemValueEventArgs コンストラクタ

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

更新 : 2007 年 11 月

DataRepeaterItemValueEventArgs クラスの新しいインスタンスを初期化します。

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

構文

'宣言
Public Sub New ( _
    itemIndex As Integer, _
    ctl As Control, _
    propertyName As String, _
    value As Object _
)
'使用
Dim itemIndex As Integer
Dim ctl As Control
Dim propertyName As String
Dim value As Object

Dim instance As New DataRepeaterItemValueEventArgs(itemIndex, _
    ctl, propertyName, value)

public DataRepeaterItemValueEventArgs(
    int itemIndex,
    Control ctl,
    string propertyName,
    Object value
)

public:
DataRepeaterItemValueEventArgs(
    int itemIndex, 
    Control^ ctl, 
    String^ propertyName, 
    Object^ value
)

public function DataRepeaterItemValueEventArgs(
    itemIndex : int, 
    ctl : Control, 
    propertyName : String, 
    value : Object
)

パラメータ

itemIndex
型 : System.Int32

イベントを発生させるコントロールを格納している DataRepeaterItem のインデックス。

ctl
型 : System.Windows.Forms.Control

イベントを発生させている子コントロール。

propertyName
型 : System.String

変更されたコントロールまたはデータが必要なコントロールのプロパティ。

value
型 : System.Object

変更されたプロパティの値。

解説

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

子コントロールの値への変更をデータストアに保存するには、ItemValuePushed イベントを使用します。

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