DataRepeater.AllowUserToAddItems, propriété

Article
09/04/2008

Mise à jour : novembre 2007

Obtient ou définit une valeur qui détermine si les utilisateurs peuvent ajouter une nouvelle ligne à un DataRepeater au moment de l'exécution.

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

Syntaxe

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)

Valeur de propriété

Type : System.Boolean

true si l'utilisateur peut ajouter des lignes ; sinon, false. La valeur par défaut est true.

Notes

Lorsque la propriété AllowUserToAddItems a la valeur True, les utilisateurs peuvent ajouter une nouvelle ligne en cliquant sur le BindingNavigatorAddNewItemToolStripButton dans le contrôle BindingNavigator ou en appuyant sur CTRL+N lorsqu'un DataRepeaterItem a le focus.

Lorsque la propriété AllowUserToAddItems a la valeur False, la fonction de clavier CTRL+N est désactivée. Par contre, le BindingNavigatorAddNewItemToolStripButton reste activé. Si vous souhaitez empêcher les utilisateurs d'ajouter des lignes, vous devez également désactiver ou supprimer le BindingNavigatorAddNewItemToolStripButton sur le contrôle BindingNavigator.

Exemples

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

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

Autorisations

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.