DataRepeater.AllowUserToAddItems-Eigenschaft

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft einen Wert ab, mit dem bestimmt wird, ob Benutzer zur Laufzeit eine neue Zeile zu einem DataRepeater-Steuerelement hinzufügen können, oder legt diesen fest.

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

Syntax

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)

Eigenschaftenwert

Typ: System.Boolean

true, wenn der Benutzer Zeilen hinzufügen kann, andernfalls false. Die Standardeinstellung ist true.

Hinweise

Wenn die AllowUserToAddItems-Eigenschaft auf True festgelegt ist, können Benutzer eine Zeile hinzufügen, indem sie im BindingNavigator-Steuerelement auf BindingNavigatorAddNewItemToolStripButton klicken oder indem sie STRG+N drücken, während ein DataRepeaterItem den Fokus hat.

Wenn die AllowUserToAddItems-Eigenschaft auf False festgelegt ist, ist die Tastenkombination STRG+N deaktiviert, BindingNavigatorAddNewItemToolStripButton ist jedoch weiterhin aktiviert. Um zu verhindern, dass Benutzer Zeilen hinzufügen, sollten Sie BindingNavigatorAddNewItemToolStripButton im BindingNavigator-Steuerelement deaktivieren oder entfernen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Schaltfläche zum Hinzufügen 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 mit dem Namen ProductsBindingSource enthält.

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

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.