New (Operador, Visual Basic)

Introduce una cláusula para crear una nueva instancia de objeto, especifica una restricción de constructor en un parámetro de tipo o identifica un procedimiento New Sub como constructor de clase.

Comentarios

En una declaración o instrucción de asignación, una cláusula debe especificar una clase definida a partir de New la cual se puede crear la instancia. Esto significa que la clase debe exponer uno o varios constructores a los que puede tener acceso el código de llamada.

Puede usar 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, llama al constructor adecuado de la clase especificada y pasa los argumentos que ha proporcionado. En el ejemplo siguiente se muestra esto mediante la creación de instancias de una clase que tiene dos constructores, uno que no toma ningún parámetro y otro Customer 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")

Puesto que las matrices son clases, puede crear una nueva instancia de New matriz, como se muestra en el ejemplo siguiente:

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 si OutOfMemoryException no hay memoria suficiente para crear la nueva instancia.

Para crear un procedimiento de constructor para una clase, establezca el nombre de un Sub procedimiento en la palabra clave New . Para obtener más información, vea Duración de objetos: Cómo se crean y destruyen los objetos.

La palabra clave New se puede usar en los siguientes contextos:

• Instrucción Dim
• De
• Instrucción Sub

Consulta también

• OutOfMemoryException
• Palabras clave
• Type List
• Tipos genéricos en Visual Basic
• Duración de los objetos: cómo se crean y destruyen