Operator New (Visual Basic)

Führt eine New-Klausel ein, um eine neue Objektinstanz zu erstellen, gibt eine Konstruktoreinschränkung auf einem Typparameter an oder identifiziert eine Sub-Prozedur als Klassenkonstruktor.

Hinweise

In einer Deklarations- oder Zuweisungsanweisung muss eine New-Klausel eine definierte Klasse angeben, aus der die Instanz erstellt werden kann. Dies bedeutet, dass die Klasse mindestens einen Konstruktor verfügbar machen muss, auf den der Aufrufcode zugreifen kann.

Sie können eine New-Klausel in Deklarationsanweisungen oder Zuweisungsanweisungen verwenden. Bei der Ausführung der Anweisung wird der entsprechende Konstruktor der angegebenen Klasse aufgerufen, und die festgelegten Argumente werden übergeben. Dies wird im folgenden Beispiel veranschaulicht. Dabei werden Instanzen einer Customer-Klasse mit zwei Konstruktoren erstellt, von denen einer keine Parameter und der andere einen Zeichenfolgenparameter annimmt.

' For customer1, call the constructor that takes no arguments.
Dim customer1 As New Customer()

' For customer2, call the constructor that takes the name of the 
' customer as an argument.
Dim customer2 As New Customer("Blue Yonder Airlines")

' For customer3, declare an instance of Customer in the first line 
' and instantiate it in the second.
Dim customer3 As Customer
customer3 = New Customer()

' With Option Infer set to On, the following declaration declares
' and instantiates a new instance of Customer.
Dim customer4 = New Customer("Coho Winery")

Da Arrays Klassen sind, kann New eine neue Arrayinstanz erstellen, wie in den folgenden Beispielen veranschaulicht.

Dim intArray1() As Integer
intArray1 = New Integer() {1, 2, 3, 4}

Dim intArray2() As Integer = {5, 6}

' The following example requires that Option Infer be set to On.
Dim intArray3() = New Integer() {6, 7, 8}

Die Common Language Runtime (CLR) löst einen OutOfMemoryException-Fehler aus, wenn nicht genügend Speicher für die Erstellung der neuen Instanz verfügbar ist.

Tipp

Das New-Schlüsselwort wird auch in Typparameterlisten verwendet, um anzugeben, dass der angegebene Typ einen zugreifbaren parameterlosen Konstruktor verfügbar machen muss. Weitere Informationen zu Typparametern und Einschränkungen finden Sie unter Typenliste (Visual Basic).

Um eine Konstruktorprozedur für eine Klasse zu erstellen, legen Sie den Namen einer Sub-Prozedur auf das New-Schlüsselwort fest. Weitere Informationen finden Sie unter Objektlebensdauer: Erstellen und Zerstören von Objekten (Visual Basic).

Das New-Schlüsselwort kann in den folgenden Kontexten verwendet werden:

Dim-Anweisung (Visual Basic)

Of-Klausel (Visual Basic)

Sub-Anweisung (Visual Basic)

Siehe auch

Referenz

Typenliste (Visual Basic)

OutOfMemoryException

Konzepte

Generische Typen in Visual Basic (Visual Basic)

Objektlebensdauer: Erstellen und Zerstören von Objekten (Visual Basic)

Weitere Ressourcen

Schlüsselwörter (Visual Basic)