Compartilhar via


Operador New (Visual Basic)

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

Comentários

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

Você pode usar um New cláusula em uma instrução de declaração ou uma instrução de atribuição.Quando a instrução é executado, ele chama o construtor apropriado da classe especificada, passando quaisquer argumentos que você forneceu.O exemplo a seguir demonstra isso através da criação de instâncias de um Customer classe que tem dois construtores, sendo que um sem parâmetros e outro que aceita um parâmetro de seqüência de caracteres.

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

Desde que as matrizes são classes, New pode criar uma nova instância de matriz, como mostrado nos exemplos 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.

ObservaçãoObservação

O New palavra-chave também é usado nas listas de parâmetro de tipo 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 tipo (Visual Basic).

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

A palavra-chave New pode ser usada nesses contextos:

Instrução (Visual Basic) Dim

Da cláusula (Visual Basic)

Instrução Sub (Visual Basic)

Consulte também

Referência

Lista de tipo (Visual Basic)

OutOfMemoryException

Conceitos

Tipos genéricos em Visual Basic (Visual Basic)

Tempo de vida do objeto: Como os objetos são criados e destruído (Visual Basic)

Outros recursos

Palavras-chave (Visual Basic)