DataRepeater.AllowUserToAddItems, propriété

Article
11/15/2012

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

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

Syntaxe

'Déclaration
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)

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é 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.

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.