DataRepeater.AllowUserToAddItems 속성

아티클
08/22/2008

업데이트: 2007년 11월

사용자가 런타임에 DataRepeater에 새 행을 추가할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

네임스페이스: Microsoft.VisualBasic.PowerPacks
어셈블리: Microsoft.VisualBasic.PowerPacks.Vs(Microsoft.VisualBasic.PowerPacks.Vs.dll)

구문

Public Property AllowUserToAddItems As Boolean

Dim instance As DataRepeater
Dim value As Boolean

value = instance.AllowUserToAddItems

instance.AllowUserToAddItems = value

public bool AllowUserToAddItems { get; set; }

public:
property bool AllowUserToAddItems {
    bool get ();
    void set (bool value);
}

public function get AllowUserToAddItems () : boolean
public function set AllowUserToAddItems (value : boolean)

속성 값

형식: System.Boolean

사용자가 행을 추가할 수 있으면 true이고, 그렇지 않으면 false입니다. 기본값은 true입니다.

설명

AllowUserToAddItems 속성이 True로 설정되어 있으면 사용자가 BindingNavigator 컨트롤에서 BindingNavigatorAddNewItemToolStripButton을 클릭하거나 DataRepeaterItem에 포커스가 있을 때 Ctrl+N을 눌러 새 행을 추가할 수 있습니다.

AllowUserToAddItems 속성이 False로 설정되어 있는 경우 CTRL+N 키보드 기능은 사용할 수 없지만 BindingNavigatorAddNewItemToolStripButton은 계속 사용할 수 있습니다. 사용자가 행을 추가하지 못하도록 하려면 BindingNavigator 컨트롤에서 BindingNavigatorAddNewItemToolStripButton도 비활성화하거나 제거해야 합니다.

예제

다음 코드 예제에서는 AllowUserToAddItems 속성이 False로 설정되어 있을 때 추가 단추를 사용할 수 없도록 설정하는 방법을 보여 줍니다. 이 예제에서는 폼에 DataRepeater1이라는 DataRepeater 컨트롤과 ProductsBindingSource라는 BindingNavigator 컨트롤이 포함되어 있는 것으로 가정합니다.

Private Sub DataRepeater1_AllowUserToAddItemsChanged(ByVal sender _
 As Object, ByVal e As System.EventArgs) Handles _
 DataRepeater1.AllowUserToAddItemsChanged
    ' If this event occurs during form initialization, exit.
    If Me.IsHandleCreated = False Then Exit Sub
    ' If AllowUserToAddItems is False.
    If DataRepeater1.AllowUserToAddItems = False Then
        ' Disable the Add button.
        BindingNavigatorAddNewItem.Enabled = False
        ' Disable the BindingSource property.
        ProductsBindingSource.AllowNew = False
    Else
        ' Otherwise, enable the Add button.
        BindingNavigatorAddNewItem.Enabled = True
    End If
End Sub

private void dataRepeater1_AllowUserToAddItemsChanged(object sender, System.EventArgs e)
{
    // If this event occurs during form initialization, exit.
    if (this.IsHandleCreated == false) { return; }
    // If AllowUserToAddItems is False.
    if (dataRepeater1.AllowUserToAddItems == false)
    // Disable the Add button.
    {
        bindingNavigatorAddNewItem.Enabled = false;
        // Disable the BindingSource property.
        productsBindingSource.AllowNew = false;
    }
    else
    {
        // Otherwise, enable the Add button.
        bindingNavigatorAddNewItem.Enabled = true;
    }
}