New (Operador, Visual Basic)New Operator (Visual Basic)

Presenta un New cláusula para crear una nueva instancia de objeto, especifica una restricción de constructor en un parámetro de tipo, o identifica una Sub procedimiento como un constructor de clase.Introduces a New clause to create a new object instance, specifies a constructor constraint on a type parameter, or identifies a Sub procedure as a class constructor.

ComentariosRemarks

En una declaración o instrucción de asignación, un New cláusula debe especificar una clase definida desde la que se puede crear la instancia.In a declaration or assignment statement, a New clause must specify a defined class from which the instance can be created. Esto significa que la clase debe exponer uno o más constructores que puede tener acceso el código de llamada.This means that the class must expose one or more constructors that the calling code can access.

Puede usar un New cláusula en una instrucción de declaración o en una instrucción de asignación.You can use a New clause in a declaration statement or an assignment statement. Cuando se ejecuta la instrucción, llama al constructor apropiado de la clase especificada, pasando los argumentos que hayan proporcionado.When the statement runs, it calls the appropriate constructor of the specified class, passing any arguments you have supplied. El ejemplo siguiente muestra mediante la creación de instancias de un Customer clase que tiene dos constructores, uno que no toma ningún parámetro y otro que toma un parámetro de cadena.The following example demonstrates this by creating instances of a Customer class that has two constructors, one that takes no parameters and one that takes a string parameter.

' 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 matriz, como se muestra en los ejemplos siguientes.Since arrays are classes, New can create a new array instance, as shown in the following examples.

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 una OutOfMemoryException error si no hay memoria suficiente para crear la nueva instancia.The common language runtime (CLR) throws an OutOfMemoryException error if there is insufficient memory to create the new instance.

Nota

El New palabra clave también se usa en las listas de parámetros de tipo para especificar que el tipo proporcionado debe exponer un constructor sin parámetros accesible.The New keyword is also used in type parameter lists to specify that the supplied type must expose an accessible parameterless constructor. Para obtener más información sobre los parámetros de tipo y restricciones, vea lista tipo.For more information about type parameters and constraints, see Type List.

Para crear un procedimiento de constructor para una clase, establezca el nombre de un Sub procedimiento a la New palabra clave.To create a constructor procedure for a class, set the name of a Sub procedure to the New keyword. Para obtener más información, consulte duración del objeto: ¿Cómo se crean y destruyen objetos.For more information, see Object Lifetime: How Objects Are Created and Destroyed.

La palabra clave New se puede usar en los siguientes contextos:The New keyword can be used in these contexts:

Dim (instrucción)Dim Statement

OfOf

Sub (instrucción)Sub Statement

Vea tambiénSee also