New, opérateur (Visual Basic)
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 :