New (Operador, Visual Basic)
Introduce una cláusula New para crear una nueva instancia de objeto, especifica una restricción de constructor en un parámetro de tipo o identifica un procedimiento Sub como constructor de clase.
Comentarios
En una declaración o instrucción de asignación, una cláusula New debe especificar una clase definida a partir de la que se pueda crear la instancia. Esto significa que la clase debe exponer uno o más constructores a los que el código de llamada pueda tener acceso.
Puede utilizar una cláusula New en una instrucción de declaración o en una instrucción de asignación. Cuando se ejecuta la instrucción, esta llama al constructor apropiado de la clase especificada y le pasa los argumentos que se le han proporcionado. En el ejemplo siguiente se muestra esto creando instancias de una clase Customer que tiene dos constructores, uno que no toma parámetros y otro que toma un parámetro de cadena.
' 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")
Dado que las matrices son clases, New puede crear una nueva instancia de la matriz, como se muestra en los ejemplos siguientes.
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}
Common Language Runtime (CLR) produce un error OutOfMemoryException si no hay memoria suficiente para crear la nueva instancia.
Nota
La palabra clave New también se usa en listas de parámetros de tipo para especificar que el tipo proporcionado debe exponer un constructor sin parámetros al que el código pueda tener acceso.Para obtener más información sobre los parámetros de tipo y las restricciones, vea Lista de tipos (Visual Basic).
Para crear un procedimiento de constructor para una clase, establezca el nombre de un procedimiento Sub en la palabra clave New. Para obtener más información, vea Duración de los objetos: cómo se crean y destruyen (Visual Basic).
La palabra clave New se puede utilizar en estos contextos:
Instrucción Dim (Visual Basic)
Sub (Instrucción, Visual Basic)
Vea también
Referencia
Conceptos
Tipos genéricos en Visual Basic (Visual Basic)
Duración de los objetos: cómo se crean y destruyen (Visual Basic)