DataRepeater.AllowUserToAddItemsChanged-Ereignis

Artikel
10/24/2012

Tritt ein, wenn sich die AllowUserToAddItems-Eigenschaft ändert.

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

Syntax

'Declaration
Public Event AllowUserToAddItemsChanged As EventHandler

public event EventHandler AllowUserToAddItemsChanged

public:
 event EventHandler^ AllowUserToAddItemsChanged {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

member AllowUserToAddItemsChanged : IEvent<EventHandler,
    EventArgs>

JScript unterstützt keine Ereignisse.

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.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Hinzufügen Schaltfläche deaktiviert, wenn die AllowUserToAddItems-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.