DataRepeater.AddNew-Methode

Artikel
10/24/2012

Fügt ein neues DataRepeaterItem dem DataRepeater-Steuerelement hinzu.

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

Syntax

'Declaration
Public Sub AddNew

public void AddNew()

public:
void AddNew()

member AddNew : unit -> unit

public function AddNew()

Ausnahmen

Ausnahme	Bedingung
ReadOnlyException	Die AllowUserToAddItems-Eigenschaft ist auf False festgelegt.

Hinweise

Verwenden Sie diese Methode, um ein neues DataRepeaterItem am unteren Rand des DataRepeater-Steuerelement anzuzeigen.Daten für die Steuerelemente in DataRepeaterItem sind leer, es sei denn, ein Ereignis oder DataSourceChanged vom Standardwert in der AddNew-Methode angegeben ist.

Wenn die AllowUserToAddItems-Eigenschaft auf Truefestgelegt ist, können Benutzer ein neues DataRepeaterItem auch hinzufügen, indem Sie auf BindingNavigatorAddNewItemToolStripButton auf dem BindingNavigator-Steuerelement klicken, oder indem Sie STRG+N drücken, wenn DataRepeaterItem den Fokus besitzt.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Standardtext in der AddNew-Methode veranschaulicht.Es wird davon ausgegangen, dass Sie über ein Formular verfügen, das Button enthält, das AddNewButton und eine Grenze DataRepeater-Steuerelement mit dem Namen DataRepeater1 , die ein TextBox-Steuerelement mit dem Namen 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";
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.