DataRepeater.AllowUserToDeleteItems 属性

更新:2007 年 11 月

获取或设置一个值,该值决定在运行时用户是否可以从 DataRepeater 删除行。

命名空间:  Microsoft.VisualBasic.PowerPacks
程序集:  Microsoft.VisualBasic.PowerPacks.Vs(在 Microsoft.VisualBasic.PowerPacks.Vs.dll 中)

语法

声明
Public Property AllowUserToDeleteItems As Boolean
用法
Dim instance As DataRepeater
Dim value As Boolean

value = instance.AllowUserToDeleteItems

instance.AllowUserToDeleteItems = value
public bool AllowUserToDeleteItems { get; set; }
public:
property bool AllowUserToDeleteItems {
    bool get ();
    void set (bool value);
}
public function get AllowUserToDeleteItems () : boolean
public function set AllowUserToDeleteItems (value : boolean)

属性值

类型:System.Boolean

如果用户可以删除行,则为 true;否则为 false。其默认值为 true。

备注

当 AllowUserToDeleteItems 属性设置为 True 时,用户可以通过单击 BindingNavigator 控件上的“BindingNavigatorDeleteItem”ToolStripButton 来删除行,或者在 DataRepeaterItem 具有焦点时通过按 Delete 来删除行。

当 AllowUserToDeleteItems 属性设置为 False 时,Delete 键盘功能将被禁用,但“BindingNavigatorDeleteItem”ToolStripButton 仍然可用。 如果要防止用户删除行,您还应该禁用或移除 BindingNavigator 控件上的“BindingNavigatorDeleteItem”ToolStripButton

示例

下面的代码示例演示当 AllowUserToAddItems 属性设置为 False 时如何禁用“Delete”(删除)ToolStripButton 按钮。 假定您有一个窗体,其中包含一个名为 DataRepeater1 的 DataRepeater 控件和一个 BindingNavigator 控件。

Private Sub DataRepeater1_AllowUserToDeleteItemsChanged _
 (ByVal sender As Object, ByVal e As System.EventArgs) Handles _
  DataRepeater1.AllowUserToDeleteItemsChanged
    ' If this event occurs during form initialization, exit.
    If Me.IsHandleCreated = False Then Exit Sub
    ' If AllowUserToDeleteItems is False.
    If DataRepeater1.AllowUserToDeleteItems = False Then
        ' Disable the Delete button.
        BindingNavigatorDeleteItem.Enabled = False
    Else
        ' Otherwise, enable the Delete button.
        BindingNavigatorDeleteItem.Enabled = True
    End If
End Sub
Private Sub BindingNavigatorDeleteItem_EnabledChanged(ByVal sender _
 As Object, ByVal e As System.EventArgs) Handles _
 BindingNavigatorDeleteItem.EnabledChanged
    If DataRepeater1.AllowUserToDeleteItems = False Then
        ' The BindingSource resets this property when a 
        ' new record is selected, so override it.
        If BindingNavigatorDeleteItem.Enabled = True Then
            BindingNavigatorDeleteItem.Enabled = False
        End If
    End If
End Sub
private void dataRepeater1_AllowUserToDeleteItemsChanged(object sender, System.EventArgs e)
{
    // If this event occurs during form initialization, exit.
    if (this.IsHandleCreated == false) { return; }
    // If AllowUserToDeleteItems is False.
    if (dataRepeater1.AllowUserToDeleteItems == false)
    // Disable the Delete button.
    {
        bindingNavigatorDeleteItem.Enabled = false;
    }
    else
    {
        // Otherwise, enable the Delete button.
        bindingNavigatorDeleteItem.Enabled = true;
    }
}
private void bindingNavigatorDeleteItem_EnabledChanged(object sender, System.EventArgs e)
{
    if (dataRepeater1.AllowUserToDeleteItems == false)
    // The BindingSource resets this property when a 
    // new record is selected, so override it.
    {
        if (bindingNavigatorDeleteItem.Enabled == true)
        {
            bindingNavigatorDeleteItem.Enabled = false;
        }
    }
}

权限

另请参见

参考

DataRepeater 类

DataRepeater 成员

Microsoft.VisualBasic.PowerPacks 命名空间

其他资源

DataRepeater 控件简介 (Visual Studio)

如何:禁止添加和删除 DataRepeater 项 (Visual Studio)