更新: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)
属性值
如果用户可以删除行,则为 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;
}
}
}
权限
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。
另请参见
参考
Microsoft.VisualBasic.PowerPacks 命名空间