DataRepeater.AllowUserToAddItems-Eigenschaft

Artikel
10/24/2012

Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob Benutzer eine neue Zeile DataRepeater zur Laufzeit hinzufügen können.

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

Syntax

'Declaration
Public Property AllowUserToAddItems As Boolean

public bool AllowUserToAddItems { get; set; }

public:
property bool AllowUserToAddItems {
    bool get ();
    void set (bool value);
}

member AllowUserToAddItems : bool with get, set

function get AllowUserToAddItems () : boolean
function set AllowUserToAddItems (value : boolean)

Eigenschaftswert

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

Hinweise

Wenn die AllowUserToAddItems-Eigenschaft auf Truefestgelegt ist, können Benutzer eine neue Zeile hinzu, indem Sie auf BindingNavigatorAddNewItemToolStripButton auf dem BindingNavigator-Steuerelement klicken, oder indem Sie STRG+N drücken, wenn DataRepeaterItem den Fokus besitzt.

Wenn die AllowUserToAddItems-Eigenschaft auf Falsefestgelegt ist, wird die Funktion für STRG+N-Tastatur deaktiviert, aber BindingNavigatorAddNewItemToolStripButton wird weiterhin aktiviert.Wenn Sie verhindern, dass Benutzer das Hinzufügen von Zeilen BindingNavigatorAddNewItemmöchten, sollten SieToolStripButton auf dem BindingNavigator-Steuerelement auch deaktivieren oder entfernen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Schaltfläche Hinzufügen AllowUserToAddItems deaktiviert, wenn die Eigenschaft auf Falsefestgelegt ist.Es wird davon ausgegangen, dass Sie über ein Formular verfügen, das ein DataRepeater-Steuerelement mit dem Namen DataRepeater1 und ein BindingNavigator-Steuerelement, das ProductsBindingSourcebenannt ist.

Private Sub DataRepeater1_AllowUserToAddItemsChanged(
    ) 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;
    }
}

.NET Framework-Sicherheit

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.