Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Fügt der zugrunde liegenden Liste ein neues Element hinzu.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public Overrides Sub AddNew
'Usage
Dim instance As CurrencyManager
instance.AddNew
public override void AddNew ()
public:
virtual void AddNew () override
public void AddNew ()
public override function AddNew ()
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die zugrunde liegende Datenquelle implementiert IBindingList nicht, oder die Datenquelle hat eine Ausnahme ausgelöst, da der Benutzer versucht hat, einer schreibgeschützten DataView oder einer solchen mit fester Größe eine Zeile hinzuzufügen. |
Hinweise
Diese Methode wird nur unterstützt, wenn die Datenquelle die IBindingList-Schnittstelle implementiert und das Hinzufügen von Zeilen ermöglicht (AllowNew ist true).
Hinweis
Diese Eigenschaft wurde entworfen, damit komplex gebundene Steuerelemente, z. B. das DataGrid-Steuerelement, der Liste neue Elemente hinzufügen können.
Sie verwenden diese Eigenschaft i. d. R. nur beim Erstellen eines eigenen Steuerelements, in das der CurrencyManager integriert ist. Fügen Sie Elemente andernfalls mithilfe einer DataView.AddNew-Methode der DataView-Klasse hinzu, wenn die Datenquelle eine DataView ist. Wenn die Datenquelle eine DataTable ist, verwenden Sie die NewRow-Methode, und fügen Sie der DataRowCollection die Zeile hinzu.
Beispiel
Im folgenden Codebeispiel wird der Liste mit der AddNew-Methode ein neues Element hinzugefügt.
Private Sub AddListItem()
' Get the CurrencyManager for a DataTable.
Dim myCurrencyManager As CurrencyManager = _
CType(Me.BindingContext(DataTable1), CurrencyManager)
myCurrencyManager.AddNew()
End Sub 'AddListItem
private void AddListItem()
{
// Get the CurrencyManager for a DataTable.
CurrencyManager myCurrencyManager =
(CurrencyManager)this.BindingContext[DataTable1];
myCurrencyManager.AddNew();
}
void AddListItem()
{
// Get the CurrencyManager for a DataTable.
CurrencyManager^ myCurrencyManager = dynamic_cast<CurrencyManager^>(this->BindingContext[ DataTable1 ]);
myCurrencyManager->AddNew();
}
private void AddListItem()
{
// Get the CurrencyManager for a DataTable.
CurrencyManager myCurrencyManager =
(CurrencyManager)(this.get_BindingContext().get_Item(dataTable1));
myCurrencyManager.AddNew();
} //AddListItem
private function AddListItem()
{
// Get the CurrencyManager for a DataTable.
var myCurrencyManager : CurrencyManager =
CurrencyManager(this.BindingContext[DataTable1]);
myCurrencyManager.AddNew();
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
CurrencyManager-Klasse
CurrencyManager-Member
System.Windows.Forms-Namespace
AllowNew
DataView.AddNew
NewRow