Instruções em Visual Basic

Uma instrução em Visual Basic é uma instrução completa.Ele pode conter palavras-chave, operadores, constantes, variáveis e expressões.Cada instrução pertence a uma das seguintes categorias:

• Instruções de declaração, que o nome de uma variável, constante ou procedimento e também pode especificar um tipo de dados.

• Instruções executáveis, que iniciar ações.Essas instruções podem chamar um método ou função e podem fazer um loop ou filiais por meio de blocos de código.Instruções executáveis incluem Instruções de atribuição, que atribui um valor ou expressão a uma variável ou constante.

Este tópico descreve cada categoria.Além disso, este tópico descreve como combinar várias instruções em uma única linha e como continuar uma instrução em várias linhas.

Declarações de Afirmação

Você usar instruções de declaração para nomear e definir procedimentos, variáveis, propriedades, matrizes e constantes.Quando você declara um elemento de programação, você também pode definir seu tipo de dados, nível de acesso e escopo.Para obter mais informações, consulte Características de elemento declarado (Visual Basic).

O exemplo a seguir contém três declarações.

Public Sub applyFormat()
    Const limit As Integer = 33
    Dim thisWidget As New widget
    ' Insert code to implement the procedure.
End Sub

A primeira declaração é a instrução Sub.Com sua instrução End Sub correspondente, ele declara um procedimento denominado applyFormat.Ela também especifica que applyFormat é Public,o que significa que qualquer código que pode fazer referência a ele pode chamá-lo.

A segunda declaração é a instrução Const, que declara a constante limit, especificando um valor de 33 e o tipo de dados Integer.

A terceira declaração é a instrução Dim, que declara a variável thisWidget.O tipo de dados é um objeto específico, um objeto criado da classe Widget a saber.Você pode declarar uma variávelpara ser de qualquer tipo de dados elementar ou de qualquer tipo de objeto que seja exposto no aplicativo que você está usando.

Valores iniciais

Quando o código que contém uma instrução de declaração é executado, Visual Basic reserva de memória exigida para o elemento declarado.Se o elemento contém um valor, Visual Basic inicializa-o para o valor padrão para seu tipo de dados.Para obter mais informações, consulte "comportamento" no Instrução (Visual Basic) Dim.

Você pode atribuir um valor inicial a uma variável como parte da sua declaração, como mostra o exemplo a seguir.

Dim m As Integer = 45
' The preceding declaration creates m and assigns the value 45 to it.

Se uma variável for uma variável de objeto, você pode criar explicitamente uma instância de sua classe quando você declará-lo usando a palavra-chave Operador New (Visual Basic), como mostra o exemplo a seguir.

Dim f As New System.Windows.Forms.Form()

Observe que o valor inicial especificado em uma instrução de declaração não é atribuído a uma variável até que a execução atinge sua instrução de declaração.Até esse momento, a variável contém o valor padrão para seu tipo de dados.

Instruções executáveis

Uma instrução executável executa uma ação.Ele pode chamar um procedimento, a ramificação para outro lugar no código, percorrer várias instruções, ou avaliar uma expressão.Uma instrução de atribuição é um caso especial de uma instrução executável.

O exemplo a seguir usa um If...Then...Else estrutura para executar diferentes blocos de código com base no valor de uma variável de controle.Em cada bloco de código, um For...Next loop é executado em um número de vezes especificado.

Public Sub startWidget(ByVal aWidget As widget,
    ByVal clockwise As Boolean, ByVal revolutions As Integer)
    Dim counter As Integer
    If clockwise = True Then
        For counter = 1 To revolutions
            aWidget.spinClockwise()
        Next counter
    Else
        For counter = 1 To revolutions
            aWidget.spinCounterClockwise()
        Next counter
    End If
End Sub

O If declaração no exemplo anterior verifica o valor do parâmetro clockwise.Se o valor for True, ele chama o spinClockwise o método de aWidget.Se o valor for False, ele chama o spinCounterClockwise o método de aWidget.O If...Then...Else estrutura de controle termina com End If.

O For...Next loop em cada bloco chama o método apropriado um número de vezes igual ao valor da revolutions parâmetro.

Instruções de atribuição

Instruções de atribuição executar operações de atribuição, que consistem em fazer o valor no lado direito do operador de atribuição (=) e armazená-la no elemento à esquerda, como no exemplo a seguir.

v = 42

No exemplo anterior, a instrução de atribuição armazena o valor literal 42 na variável v.

Elementos de programação qualificados

O elemento de programação no lado esquerdo do operador de atribuição deve ser capaz de aceitar e armazenar um valor.Isso significa que ele deve ser uma variável ou propriedade que não é ReadOnly (Visual Basic), ou deve ser um elemento de matriz.No contexto de uma instrução de atribuição, esse elemento é chamado, às vezes, um lvalue, para "valor esquerdo".

O valor no lado direito do operador de atribuição é gerado por uma expressão, que pode consistir em qualquer combinação de literais, constantes, variáveis, propriedades, elementos de matriz, outras expressões ou chamadas de função.O exemplo a seguir ilustra isto:

x = y + z + findResult(3)

O exemplo anterior adiciona o valor armazenado na variável y para o valor armazenado na variável ze, em seguida, adiciona o valor retornado pela chamada à função findResult.O valor total dessa expressão é então armazenado na variável x.

Tipos de dados em instrução de atribuição

Com valores numéricos, o operador de atribuição também pode atribuir String valores, como ilustra o exemplo a seguir.

Dim a, b As String
a = "String variable assignment"
b = "Con" & "cat" & "enation"
' The preceding statement assigns the value "Concatenation" to b.

Você também pode atribuir Boolean valores, usando um Boolean literal ou um Boolean a expressão, como o exemplo a seguir ilustra.

Dim r, s, t As Boolean
r = True
s = 45 > 1003
t = 45 > 1003 Or 45 > 17
' The preceding statements assign False to s and True to t.

Da mesma forma, você pode atribuir valores apropriados para elementos de programação da Char, Date, ou Object tipo de dados.Você também pode atribuir uma instância de objeto a um elemento declarado como a classe da qual essa instância é criada.

Instruções de atribuição compostas

Instruções de atribuição de compostos primeiro realizar uma operação em uma expressão antes de atribuí-la a um elemento de programação.O exemplo a seguir ilustra um desses operadores, +=, que incrementa o valor da variável no lado esquerdo do operador pelo valor da expressão à direita.

n += 1

O exemplo anterior adiciona 1 ao valor de ne, em seguida, armazena esse novo valor em n.Ele é uma estenografia equivalente da instrução a seguir:

n = n + 1

Uma variedade de operações de atribuição compostos pode ser executada usando operadores deste tipo.Para obter uma lista desses operadores e mais informações sobre eles, consulte Operadores de atribuição (Visual Basic).

O operador de atribuição de concatenação (&=) é útil para adicionar uma seqüência de caracteres ao final da já existentes em seqüências de caracteres, como o exemplo a seguir ilustra.

Dim q As String = "Sample "
q &= "String"
' q now contains "Sample String".

Conversões de tipo em instrução de atribuição

O valor que você atribuir a uma variável, propriedade ou elemento de matriz deve ser de um tipo de dados apropriado a esse elemento de destino.Em geral, você deve tentar gerar um valor do mesmo tipo de dados que o elemento de destino.No entanto, alguns tipos podem ser convertidos para outros tipos durante a atribuição.

Para obter informações sobre como converter entre tipos de dados, consulte Conversões de tipo em Visual Basic.Em resumo, Visual Basic automaticamente converte um valor de um determinado tipo em qualquer outro tipo ao qual ele amplia.A widening conversão é um em que sempre é bem-sucedida em tempo de execução e não perderá nenhum dado.Por exemplo, Visual Basic converte uma Integer valor para Double quando apropriado, pois Integer expande em Double.Para obter mais informações, consulte Ampliação e restrição de conversões (Visual Basic).

Restringir conversões (aqueles que não são tipos de dados) transportar um risco de falha em tempo de execução ou de perda de dados.Você pode executar uma conversão de restrição de explicitamente usando uma função de conversão de tipo, ou você pode instruir o compilador para realizar todas as conversões implicitamente definindo Option Strict Off.Para obter mais informações, consulte Conversões implícitas e explícitas (Visual Basic).

Colocar várias instruções em uma linha

Você pode ter várias instruções em uma única linha, separada por dois-pontos (:) caracteres.O exemplo a seguir ilustra isto:

Dim sampleString As String = "Hello World" : MsgBox(sampleString)

Embora ocasionalmente conveniente, essa forma de sintaxe torna o código difícil de ler e manter.Assim, é recomendável que você mantenha uma instrução para uma linha.

Continuar uma instrução em várias linhas

Uma instrução geralmente se encaixa em uma linha, mas quando for muito longo, pode continuar até a próxima linha, usando uma seqüência de continuação de linha, que consiste em um espaço seguido por um caractere de sublinhado (_) seguido por um retorno de carro.No exemplo a seguir, o MsgBox instrução executável é continuação em duas linhas.

Public Sub demoBox()
    Dim nameVar As String
    nameVar = "John"
    MsgBox("Hello " & nameVar _
        & ". How are you?")
End Sub

Continuação de linha implícita

Em muitos casos, você pode continuar uma instrução na linha seguinte consecutiva sem usar o caractere de sublinhado (_).A tabela a seguir lista os elementos de sintaxe que implicitamente continuam a instrução na próxima linha de código.

Elemento de sintaxe	Exemplo
Depois de uma vírgula (,).	Public Function GetUsername(ByVal username As String, ByVal delimiter As Char, ByVal position As Integer) As String Return username.Split(delimiter)(position) End Function
Após um parêntese de aberto (() ou antes de um parêntese de fechamento ()).	Dim username = GetUsername( Security.Principal.WindowsIdentity.GetCurrent().Name, CChar("\"), )
Depois de uma chave aberta ({) ou antes de uma chave de fechamento (}).	Dim customer = New Customer With { .Name = "Terry Adams", .Company = "Adventure Works", .Email = "terry@www.adventure-works.com" } Para obter mais informações, consulte Inicializadores de objeto: Nomeados e anônimos tipos (Visual Basic) ou Inicializadores de coleção (Visual Basic).
Após uma abertura expressão incorporada (<%=) ou antes do fechamento de uma expressão incorporada (%>) dentro de um literal XML.	Dim customerXml = <Customer> <Name> <%= customer.Name %> </Name> <Email> <%= customer.Email %> </Email> </Customer> Para obter mais informações, consulte Expressões incorporadas em XML (Visual Basic).
Após o operador de concatenação (&).	cmd.CommandText = "SELECT * FROM Titles JOIN Publishers " & "ON Publishers.PubId = Titles.PubID " & "WHERE Publishers.State = 'CA'" Para obter mais informações, consulte Operadores listados pela funcionalidade (Visual Basic).
After assignment operators (=, &=, :=, +=, -=, *=, /=, \=, ^=, <<=, >>=).	Dim fileStream = My.Computer.FileSystem. OpenTextFileReader(filePath) Para obter mais informações, consulte Operadores listados pela funcionalidade (Visual Basic).
After binary operators (+, -, /, *, Mod, <>, <, >, <=, >=, ^, >>, <<, And, AndAlso, Or, OrElse, Like, Xor) within an expression.	Dim memoryInUse = My.Computer.Info.TotalPhysicalMemory + My.Computer.Info.TotalVirtualMemory - My.Computer.Info.AvailablePhysicalMemory - My.Computer.Info.AvailableVirtualMemory Para obter mais informações, consulte Operadores listados pela funcionalidade (Visual Basic).
Após a Is e IsNot operadores.	If TypeOf inStream Is IO.FileStream AndAlso inStream IsNot Nothing Then ReadFile(inStream) End If Para obter mais informações, consulte Operadores listados pela funcionalidade (Visual Basic).
Depois de um caractere de qualificador de membro (.) e antes do nome do membro.No entanto, você deve incluir um caractere de continuação de linha (_) após um caractere de qualificador de membro quando você estiver usando o With de instrução ou fornecer valores na lista para um tipo de inicialização.Considere a possibilidade de quebra de linha após o operador de atribuição (por exemplo, =) quando você estiver usando With instruções ou listas de inicialização do objeto.	Dim fileStream = My.Computer.FileSystem. OpenTextFileReader(filePath) ... ' Not allowed: ' Dim aType = New With { . ' PropertyName = "Value" ' Allowed: Dim aType = New With {.PropertyName = "Value"} Dim log As New EventLog() ' Not allowed: ' With log ' . ' Source = "Application" ' End With ' Allowed: With log .Source = "Application" End With Para obter mais informações, consulte Com...Terminam com a instrução (Visual Basic) ou Inicializadores de objeto: Nomeados e anônimos tipos (Visual Basic).
Após um qualificador de propriedade de eixo XML (. ou .@ ou ...).No entanto, você deve incluir um caractere de continuação de linha (_) ao especificar um qualificador de membro quando você estiver usando o With palavra-chave.	Dim customerName = customerXml. <Name>.Value Dim customerEmail = customerXml... <Email>.Value Para obter mais informações, consulte Propriedades de eixo XML (Visual Basic).
Depois de um menor-sinal (<) ou antes de uma maior-sinal (>) quando você especifica um atributo.Além disso, após um maior-sinal (>) quando você especifica um atributo.No entanto, você deve incluir um caractere de continuação de linha (_) quando você especifica os atributos de nível de assembly ou nível de módulo.	< Serializable() > Public Class Customer Public Property Name As String Public Property Company As String Public Property Email As String End Class Para obter mais informações, consulte Atributos (C# e Visual Basic).
Before and after query operators (Aggregate, Distinct, From, Group By, Group Join, Join, Let, Order By, Select, Skip, Skip While, Take, Take While, Where, In, Into, On, Ascending, and Descending).Você não pode quebrar uma linha entre as palavras-chave dos operadores de consulta são constituídos por várias palavras-chave (Order By, Group Join, Take While, e Skip While).	Dim vsProcesses = From proc In Process.GetProcesses Where proc.MainWindowTitle.Contains("Visual Studio") Select proc.ProcessName, proc.Id, proc.MainWindowTitle Para obter mais informações, consulte Consultas (Visual Basic).
Após a In palavra-chave em um For Each instrução.	For Each p In vsProcesses Console.WriteLine("{0}" & vbTab & "{1}" & vbTab & "{2}", p.ProcessName, p.Id, p.MainWindowTitle) Next Para obter mais informações, consulte Para cada...Próxima instrução (Visual Basic).
Após a From palavra-chave em um inicializador de coleção.	Dim days = New List(Of String) From { "Mo", "Tu", "We", "Th", "F", "Sa", "Su" } Para obter mais informações, consulte Inicializadores de coleção (Visual Basic).

Adicionando comentários

Código-fonte nem sempre é auto-explicativo, mesmo para o programador que o escreveu.Para ajudar a documentar o seu código, portanto, a maioria dos programadores fazer uso livre de comentários incorporados.Comentários no código podem explicar um procedimento ou uma instrução específica para qualquer pessoa que ler ou trabalhar com ele mais tarde.Visual Basicignora os comentários durante a compilação, e elas não afetam o código compilado.

Linhas de comentários começam com um apóstrofo (') ou REM seguido por um espaço.Eles podem ser adicionados em qualquer lugar no código, exceto dentro de uma seqüência.Para acrescentar um comentário a uma instrução, insira um apóstrofo ou REM após a instrução, seguida do comentário.Comentários também podem ir em sua própria linha separada.O exemplo a seguir demonstra uma dessas possibilidades.

' This is a comment on a separate code line.
REM This is another comment on a separate code line.
x += a(i) * b(i) ' Add this amount to total.
MsgBox(statusMessage) REM Inform operator of status.

A verificação de erros de compilação

Se, após você digitar uma linha de código, a linha é exibida com um sublinhado azul ondulado (uma mensagem de erro pode aparecer também), há um erro de sintaxe na instrução.Você deve descobrir o que há de errado com a instrução (por procurando em uma lista de tarefas, ou focalizando o erro com o ponteiro do mouse e ler a mensagem de erro) e corrigi-la.Até você corrigir todos os erros de sintaxe em seu código, seu programa não será compilado corretamente.

Seções relacionadas

Termo	Definição
Operadores de atribuição (Visual Basic)	Fornece links para páginas de referência de linguagem, cobrindo os operadores de atribuição, como =, *=, e &=.
Operadores e expressões em Visual Basic	Mostra como combinar elementos com operadores para gerar novos valores.
Como: quebrar e combinar instruções no código (Visual Basic)	Mostra como dividir uma única instrução em várias linhas e como colocar várias instruções na mesma linha.
Como: instruções de rótulo (Visual Basic)	Mostra como rotular uma linha de código.