Novo operador (Visual Basic)

  • Artigo

Introduz uma New cláusula para criar uma nova instância de objeto, especifica uma restrição de construtor em um parâmetro type ou identifica um Sub procedimento como um construtor de classe.

Observações

Em uma declaração ou instrução de atribuição, uma New cláusula deve especificar uma classe definida a partir da qual a instância pode ser criada. Isso significa que a classe deve expor um ou mais construtores que o código de chamada pode acessar.

Você pode usar uma New cláusula em uma declaração ou uma declaração de atribuição. Quando a instrução é executada, ela chama o construtor apropriado da classe especificada, passando todos os argumentos fornecidos. O exemplo a seguir demonstra isso criando instâncias de uma Customer classe que tem dois construtores, um que não usa parâmetros e outro que usa um parâmetro string:

' 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")

Como as matrizes são classes, New é possível criar uma nova instância de matriz, conforme mostrado no exemplo a seguir:

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}

O Common Language Runtime (CLR) lança um OutOfMemoryException erro se não houver memória suficiente para criar a nova instância.

Nota

A New palavra-chave também é usada em listas de parâmetros type para especificar que o tipo fornecido deve expor um construtor sem parâmetros acessível. Para obter mais informações sobre parâmetros de tipo e restrições, consulte Lista de tipos.

Para criar um procedimento de construtor para uma classe, defina o nome de um Sub procedimento para a New palavra-chave. Para obter mais informações, consulte Tempo de vida do objeto: como os objetos são criados e destruídos.

A New palavra-chave pode ser usada nestes contextos:

Consulte também