New, opérateur (Visual Basic)

  • Article

Introduit une clause New pour créer une instance d’objet, spécifie une contrainte de constructeur sur un paramètre de type ou identifie une procédure Sub comme constructeur de classe.

Notes

Dans une instruction de déclaration ou d’affectation, 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’affectation. Lorsque l’instruction s’exécute, 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, une qui ne prend aucun paramètre et une qui prend 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 instance de tableau, comme illustré dans l’exemple suivant :

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) génère une erreur OutOfMemoryException en cas d’insuffisance de mémoire pour créer la nouvelle instance.

Notes

Le mot clé New est également utilisé dans les listes de paramètres de type pour 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.

Pour créer une procédure de constructeur pour une classe, définissez le nom d’une procédure Sub sur le mot clé New. Pour plus d’informations, consultez Durée de vie d’un objet : création et destruction des objets.

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

Voir aussi