DataRepeater.CurrentItemIndex 屬性

發行項
08/21/2008

更新：2007 年 11 月

取得或設定 DataRepeater 控制項中的目前 DataRepeaterItem。

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

語法

<BrowsableAttribute(False)> _
Public Property CurrentItemIndex As Integer

Dim instance As DataRepeater
Dim value As Integer

value = instance.CurrentItemIndex

instance.CurrentItemIndex = value

[BrowsableAttribute(false)]
public int CurrentItemIndex { get; set; }

[BrowsableAttribute(false)]
public:
property int CurrentItemIndex {
    int get ();
    void set (int value);
}

public function get CurrentItemIndex () : int
public function set CurrentItemIndex (value : int)

屬性值

型別：System.Int32

目前 DataRepeaterItem 的索引。

備註

這個屬性可以用來傳回或變更 DataRepeater 控制項中 CurrentItem 的索引。設定 CurrentItemIndex 屬性會將具有相等索引的 DataRepeaterItem 捲動到檢視處。

注意事項：
使用捲動最少項目策略，會將 DataRepeaterItem 完整捲動到檢視處。若要將項目對齊 DataRepeater 頂端，請呼叫 ScrollItemIntoView 方法，為 AlignWithTop 參數指定 true。

範例

在下列範例中，會示範 CurrentItemIndex 屬性的用法，根據搜尋的結果，將焦點設定給 DataRepeater 控制項中的項目。這個範例假設您的表單上有一個名為 DataRepeater1 的 DataRepeater 控制項、一個名為 SearchTextBox 的 TextBox、一個名為 SearchButton 的 Button，而且 DataRepeater 已繫結至 Northwind 資料庫 Products 資料表的資料來源。

Private Sub SearchButton_Click(ByVal sender As System.Object, ByVal e As  _
  System.EventArgs) Handles SearchButton.Click
    Dim foundIndex As Integer
    Dim searchString As String
    searchString = SearchTextBox.Text
    foundIndex = ProductsBindingSource.Find("ProductID", _
     searchString)
    If foundIndex > -1 Then
        DataRepeater1.CurrentItemIndex = foundIndex
    Else
        MsgBox("Item " & searchString & " not found.")
    End If
End Sub

private void searchButton_Click(System.Object sender, System.EventArgs e)
{
    int foundIndex;
    string searchString;
    searchString = searchTextBox.Text;
    foundIndex = productsBindingSource.Find("ProductID", searchString);
    if (foundIndex > -1)
    {
        dataRepeater1.CurrentItemIndex = foundIndex;
    }
    else
    {
        MessageBox.Show("Item " + searchString + " not found.");
    }
}