Freigeben über


DataRepeater.AllowUserToAddItems-Eigenschaft

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

Siehe auch

Referenz

DataRepeater-Klasse

DataRepeater-Member

Microsoft.VisualBasic.PowerPacks-Namespace

Weitere Ressourcen

Einführung in das DataRepeater-Steuerelement (Visual Studio)

Gewusst wie: Deaktivieren des Hinzufügens und Löschens von DataRepeater-Elementen (Visual Studio)