DataRepeater.AllowUserToDeleteItems-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab, mit dem bestimmt wird, ob Benutzer zur Laufzeit eine Zeile aus DataRepeater löschen können, oder legt diesen fest.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

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)

Eigenschaftenwert

Typ: System.Boolean

true, wenn Zeilen gelöscht werden können, andernfalls false. Die Standardeinstellung ist true.

Hinweise

Wenn die AllowUserToDeleteItems-Eigenschaft auf True festgelegt ist, können Benutzer Zeilen löschen, indem sie im BindingNavigator-Steuerelement auf BindingNavigatorDeleteItemToolStripButton klicken oder indem sie die ENTF-Taste drücken, während ein DataRepeaterItem den Fokus hat.

Wenn die AllowUserToDeleteItems-Eigenschaft auf False festgelegt ist, ist die Tastaturfunktion ENTF deaktiviert, BindingNavigatorDeleteItemToolStripButton ist jedoch weiterhin aktiviert. Um zu verhindern, dass Benutzer Zeilen löschen, sollten Sie BindingNavigatorDeleteItemToolStripButton im BindingNavigator-Steuerelement deaktivieren oder entfernen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Schaltfläche zum Löschen (ToolStripButton) deaktivieren, wenn die AllowUserToAddItems-Eigenschaft auf False festgelegt ist. Es wird davon ausgegangen, dass ein Formular vorhanden ist, das ein DataRepeater-Steuerelement mit dem Namen DataRepeater1 sowie ein BindingNavigator-Steuerelement enthält.

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.