DataRepeater.AllowUserToAddItemsChanged-Ereignis

Artikel
08/23/2008

Aktualisiert: November 2007

Wird ausgelöst, wenn sich die AllowUserToAddItems-Eigenschaft ändert.

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

Syntax

Public Event AllowUserToAddItemsChanged As EventHandler

Dim instance As DataRepeater
Dim handler As EventHandler

AddHandler instance.AllowUserToAddItemsChanged, handler

public event EventHandler AllowUserToAddItemsChanged

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

JScript unterstützt keine Ereignisse.

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.

Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Schaltfläche 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.