Propriedade DataRepeater.AllowUserToDeleteItems

Artigo
10/26/2012

Obtém ou define um valor que determina se os usuários podem excluir uma linha a partir de um DataRepeater em tempo de execução.

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

Sintaxe

'Declaração
Public Property AllowUserToDeleteItems As Boolean

public bool AllowUserToDeleteItems { get; set; }

public:
property bool AllowUserToDeleteItems {
    bool get ();
    void set (bool value);
}

member AllowUserToDeleteItems : bool with get, set

function get AllowUserToDeleteItems () : boolean
function set AllowUserToDeleteItems (value : boolean)

Valor de propriedade

Tipo: System.Boolean
true Se o usuário pode excluir linhas; Caso contrário, false.O padrão é true.

Comentários

Quando o AllowUserToDeleteItems propriedade estiver definida como True, os usuários podem excluir linhas clicando o BindingNavigatorDeleteItemToolStripButton na BindingNavigator controle, ou pressionando exclusão quando um DataRepeaterItem tem foco.

Quando o AllowUserToDeleteItems propriedade estiver definida como False, a função do teclado de exclusão for desabilitada, mas o BindingNavigatorDeleteItemToolStripButton ainda está ativado.Se você quiser impedir que os usuários excluam linhas, você também deve desabilitar ou remover o BindingNavigatorDeleteItemToolStripButton sobre o BindingNavigator controle.

Exemplos

O exemplo de código a seguir demonstra como desabilitar a exclusão ToolStripButton quando o AllowUserToAddItems propriedade estiver definida como False.Ele presume que você tenha um formulário que contém um DataRepeater controle denominado DataRepeater1 e um BindingNavigator controle.

Private Sub DataRepeater1_AllowUserToDeleteItemsChanged(
    ) Handles DataRepeater1.AllowUserToDeleteItemsChanged

    ' If this event occurs during form initialization, exit.
    If Me.IsHandleCreated = False Then Exit Sub
    ' If AllowUserToDeleteItems is False.
    If DataRepeater1.AllowUserToDeleteItems = False Then
        ' Disable the Delete button.
        BindingNavigatorDeleteItem.Enabled = False
    Else
        ' Otherwise, enable the Delete button.
        BindingNavigatorDeleteItem.Enabled = True
    End If
End Sub
Private Sub BindingNavigatorDeleteItem_EnabledChanged(
    ) Handles BindingNavigatorDeleteItem.EnabledChanged

    If DataRepeater1.AllowUserToDeleteItems = False Then
        ' The BindingSource resets this property when a 
        ' new record is selected, so override it.
        If BindingNavigatorDeleteItem.Enabled = True Then
            BindingNavigatorDeleteItem.Enabled = False
        End If
    End If
End Sub

private void dataRepeater1_AllowUserToDeleteItemsChanged(object sender, System.EventArgs e)
{
    // If this event occurs during form initialization, exit.
    if (this.IsHandleCreated == false) { return; }
    // If AllowUserToDeleteItems is False.
    if (dataRepeater1.AllowUserToDeleteItems == false)
    // Disable the Delete button.
    {
        bindingNavigatorDeleteItem.Enabled = false;
    }
    else
    {
        // Otherwise, enable the Delete button.
        bindingNavigatorDeleteItem.Enabled = true;
    }
}
private void bindingNavigatorDeleteItem_EnabledChanged(object sender, System.EventArgs e)
{
    if (dataRepeater1.AllowUserToDeleteItems == false)
    // The BindingSource resets this property when a 
    // new record is selected, so override it.
    {
        if (bindingNavigatorDeleteItem.Enabled == true)
        {
            bindingNavigatorDeleteItem.Enabled = false;
        }
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.