Método DataRepeater.AddNew

Artigo
10/26/2012

Adiciona um novo DataRepeaterItem para o DataRepeater controle.

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

Sintaxe

'Declaração
Public Sub AddNew

public void AddNew()

public:
void AddNew()

member AddNew : unit -> unit

public function AddNew()

Exceções

Exceção	Condição
ReadOnlyException	A propriedade AllowUserToAddItems é definida como False.

Comentários

Use este método para exibir uma nova DataRepeaterItem na parte inferior do DataRepeater controle.Dados para os controles a DataRepeaterItem ficará em branco, a menos que um valor padrão é fornecido pelo DataSourceChanged evento ou na AddNew método.

Quando o AllowUserToAddItems propriedade estiver definida como True, os usuários também podem adicionar um novo DataRepeaterItem clicando o BindingNavigatorAddNewItemToolStripButton na BindingNavigator controle, ou pressionando CTRL + N quando um DataRepeaterItem tem foco.

Exemplos

O exemplo a seguir demonstra como definir o texto padrão AddNew método.Ele presume que você tenha um formulário que contém um Button chamado AddNewButton e um limite DataRepeater controle denominado DataRepeater1 que contém um TextBox controle denominado ProductNameTextBox.

Private Sub AddNewButton_Click() Handles AddNewButton.Click
    ' Add a new repeater item.
    DataRepeater1.AddNew()
    ' Set the default text.
    DataRepeater1.CurrentItem.Controls("ProductNameTextBox").Text = 
       "New Product"
End Sub

private void addNewButton_Click(object sender, System.EventArgs e)
{
    // Add a new repeater item.
    dataRepeater1.AddNew();
    // Set the default text.
    dataRepeater1.CurrentItem.Controls["productNameTextBox"].Text = "New Product";
}

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.