New, opérateur (Visual Basic)

Présente une clause New pour créer une instance de l'objet, spécifie une contrainte de constructeur sur un paramètre de type ou identifie une procédure Sub en tant que constructeur de classe.

Notes

Dans une instruction de déclaration ou d'assignation, une clause New doit spécifier une classe définie à partir de laquelle l'instance peut être créée. Cela signifie que la classe doit exposer un ou plusieurs constructeurs auxquels le code appelant peut accéder.

Vous pouvez utiliser une clause New dans une instruction de déclaration ou une instruction d'assignation. Lorsque l'instruction est exécutée, elle appelle le constructeur approprié de la classe spécifiée, en passant les arguments que vous avez fournis. L'exemple suivant illustre cela en créant des instances d'une classe Customer qui a deux constructeurs, l'un ne prenant aucun paramètre et l'autre prenant un paramètre de chaîne.

' 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")

Étant donné que les tableaux sont des classes, New peut créer une nouvelle instance de tableau, comme indiqué dans les exemples suivants.

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}

Le Common Language Runtime (CLR) lève une erreur OutOfMemoryException s'il n'y a pas assez de mémoire pour créer la nouvelle instance.

Notes

Le mot clé New est aussi utilisé dans des listes de paramètres de type afin de spécifier que le type fourni doit exposer un constructeur sans paramètre accessible. Pour plus d'informations sur les paramètres de type et les contraintes, consultez Liste de types (Visual Basic).

Pour créer une procédure de constructeur pour une classe, affectez au nom d'une procédure Sub le mot clé New. Pour plus d'informations, consultez Durée de vie d'un objet : création et destruction des objets (Visual Basic).

Le mot clé New peut être utilisé dans les contextes suivants :

Dim, instruction (Visual Basic)

Of, clause (Visual Basic)

Sub, instruction (Visual Basic)

Voir aussi

Référence

Liste de types (Visual Basic)

OutOfMemoryException

Concepts

Types génériques en Visual Basic (Visual Basic)

Durée de vie d'un objet : création et destruction des objets (Visual Basic)

Autres ressources

Mots clés (Visual Basic)