DataRepeater.AllowUserToAddItemsChanged, événement

Article
11/15/2012

Se produit lorsque la propriété AllowUserToAddItems change.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
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 ne prend pas en charge les événements.

Notes

Lorsque la propriété d'AllowUserToAddItems est définie à True, les utilisateurs peuvent ajouter une nouvelle ligne en cliquant sur BindingNavigatorAddNewItemToolStripButton sur le contrôle d'BindingNavigator, ou en appuyant sur CTRL+N lorsque DataRepeaterItem a le focus.

Lorsque la propriété d'AllowUserToAddItems est définie à False, la fonction de clavier de CTRL+N est désactivée, mais BindingNavigatorAddNewItemToolStripButton est encore activé.Si vous souhaitez empêcher des utilisateurs des lignes d'ajout, vous devez également désactiver ou supprimer BindingNavigatorAddNewItemToolStripButton sur le contrôle d'BindingNavigator.

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

Exemples

L'exemple de code suivant montre comment désactiver le bouton d'Ajouter lorsque la propriété d'AllowUserToAddItems est définie à False.Il suppose que vous avez un formulaire qui contient un contrôle d'DataRepeater nommé DataRepeater1 et un contrôle d'BindingNavigator nommé ProductsBindingSource.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.