Instruções no Visual Basic

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

• Instruções de declaração, que o nome de uma variável, constante ou procedimentoe 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çãoe eles podem loop ou ramificar 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 continuar uma demonstrativo em várias linhas.

Declaration Statements

You use declaration statements to name and define procedures, variables, properties, arrays, and constants. When you declare a programming element, you can also define its data type, access level, and scope. For more information, see Características do elemento declarado (Visual Basic).

The following example contains three declarations.

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

The first declaration is the Sub statement. Together with its matching End Sub statement, it declares a procedure named applyFormat. It also specifies that applyFormat is Public, which means that any code that can refer to it can call it.

The second declaration is the Const statement, which declares the constant limit, specifying the Integer data type and a value of 33.

The third declaration is the Dim statement, which declares the variable thisWidget. The data type is a specific object, namely an object created from the Widget class. You can declare a variable to be of any elementary data type or of any object type that is exposed in the application you are using.

Initial Values

When the code containing a declaration statement runs, Visual Basic reserves the memory required for the declared element. If the element holds a value, Visual Basic initializes it to the default value for its data type. For more information, see "Behavior" in Instrução Dim (Visual Basic).

You can assign an initial value to a variable as part of its declaration, as the following example illustrates.

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

If a variable is an object variable, you can explicitly create an instance of its class when you declare it by using the operador New (Visual Basic) keyword, as the following example illustrates.

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

Note that the initial value you specify in a declaration statement is not assigned to a variable until execution reaches its declaration statement. Until that time, the variable contains the default value for its data type.

Instruções executáveis

Umademonstrativo de executávelexecuta uma ação. Ele pode chamar um procedimento, a ramificar para outro lugar no código, o loop por meio de várias instruções, ou avaliar uma expressão. Uma instrução de atribuição é um caso especial de umademonstrativodo executável.

O exemplo a seguir utiliza um If...Then...Else estrutura para executar diferentes blocos de código com base no valor de uma variávelde controle. Em cada bloco de código, um For...Nextdeloop é 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 Ifademonstrativo no exemplo anterior verifica o valor do parâmetro clockwise. Se o valor for True, ele chama o spinClockwiseométodo de aWidget. Se o valor for False, ele chama o spinCounterClockwiseométodo de aWidget. O If...Then...Else estrutura de controle termina com End If.

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

Instruções de atribuição

Instruções de atribuição executam operações de atribuição, que consistem em tirar o valor à direita 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ávelv.

Eligible Programming Elements

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 um lvalue, "valor esquerdo".

O valor à direita do operador de atribuição é gerado por uma expressão, que pode consistir em qualquer combinação de literais, constantes, variáveis, propriedades, os elementos de matriz, outras expressões ou chamadas de função . The following example illustrates this.

x = y + z + findResult(3)

O exemplo anterior adiciona o valor mantido na variável y para o valor mantido 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ções de atribuição

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

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 de compostos

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 para o valor de ne em seguida, armazena esse valor de novo no n. Ele é uma estenografia equivalente a demonstrativoa 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".

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

O valor que você atribuir a uma variável, propriedadeou 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 de durante a atribuição.

Para obter informações sobre como converter entre tipos de dados, consulte Conversões de Tipo no Visual Basic. Em resumo, Visual Basic converte automaticamente 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 o valor para Double quando apropriado, pois Integer amplia a Double. For more information, see Conversões de expansão e restrição (Visual Basic).

Restringir as conversões (aqueles que não são alargamento) transportar um risco de falha em tempo de execução ou de perda de dados. Você pode executar uma conversão de restrição explicitamente usando uma funçãode conversão de tipo ou você pode instruir o compilador para realizar todas as conversões implicitamente pela configuração Option Strict Off. For more information, see Conversões explícitas e implícitas (Visual Basic).

Colocar várias instruções em uma linha

Você pode ter várias instruções em uma única linha separados por dois-pontos (:) caracteres. The following example illustrates this.

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

Embora ocasionalmente conveniente, este formulário de sintaxe torna seu código difícil de ler e manter. Portanto, é recomendável que você mantenha uma demonstrativo para uma linha.

Continuar uma instrução em várias linhas

Uma demonstrativo geralmente se encaixa em uma linha, mas quando ele é muito longo, pode continuar até a próxima linha usando uma linha-continuação sequência, que consiste em um espaço seguido por um caractere de sublinhado (_) seguido por um retorno de carro. No exemplo a seguir, o doMsgBoxexecutáveldemonstrativo é 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 demonstrativo na próxima linha consecutivas sem usar o caractere de sublinhado (_). A tabela a seguir lista os elementos de sintaxe que implicitamente continuam a demonstrativo na próxima linha de código.

Elemento de sintaxe	Example
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 em aberto (() ou antes de um parêntese de fechamento ()).	Dim username = GetUsername( Security.Principal.WindowsIdentity.GetCurrent().Name, CChar("\"), )
Depois de uma chave de abertura em aberto ({) ou antes de uma chave de fechamento (}).	Dim customer = New Customer With { .Name = "Terry Adams", .Company = "Adventure Works", .Email = "terry@www.adventure-works.com" } For more information, see Inicializadores de objeto: Tipos nomeados e anônimos (Visual Basic) or Visão geral sobre inicializadores de coleção (Visual Basic).
Após um em aberto a expressão incorporada (<%=) ou antes de fechar de uma expressão incorporada (%>) dentro de um literal XML .	Dim customerXml = <Customer> <Name> <%= customer.Name %> </Name> <Email> <%= customer.Email %> </Email> </Customer> For more information, see Expressões inseridas no 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'" For more information, see Operadores listados por Funcionalidade (Visual Basic).
After assignment operators (=, &=, :=, +=, -=, *=, /=, \=, ^=, <<=, >>=).	Dim fileStream = My.Computer.FileSystem. OpenTextFileReader(filePath) For more information, see Operadores listados por Funcionalidade (Visual Basic).
After binário 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 For more information, see Operadores listados por 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 For more information, see Operadores listados por Funcionalidade (Visual Basic).
Depois de um caractere de qualificador de membro (.) e antes do nome do membro. No entanto, você deve incluir uma linha-caractere de continuação (_) após um caractere de qualificador de membro, quando você estiver usando o With demonstrativo ou supplying valores da lista de inicialização para um tipo. 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 deinicializaçã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 For more information, see Declaração With...End With (Visual Basic) or Inicializadores de objeto: Tipos nomeados e anônimos (Visual Basic).
Após um de propriedadede eixo XMLqualificador (. ou .@ ou ...). No entanto, você deve incluir uma linha-o caractere de continuação (_) quando você especificar um qualificador de membro quando você estiver usando o With palavra-chave.	Dim customerName = customerXml. <Name>.Value Dim customerEmail = customerXml... <Email>.Value For more information, see Propriedades de eixo XML (Visual Basic).
Após um menos-sinal (<) ou antes de um-maior que o sinal (>) quando você especificar um atributo. Também após um-maior que o sinal (>) quando você especificar um atributo. No entanto, você deve incluir uma linha-o caractere de continuação (_), quando você especifica que o assembly-nível ou módulo-atributos no nível.	< Serializable() > Public Class Customer Public Property Name As String Public Property Company As String Public Property Email As String End Class For more information, see Atributos (C# e Visual Basic).
Before and after consulta 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 compostos de 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 For more information, see Consultas(Visual Basic).
Após a Inapalavra-chave em um For Eachdemonstrativo.	For Each p In vsProcesses Console.WriteLine("{0}" & vbTab & "{1}" & vbTab & "{2}", p.ProcessName, p.Id, p.MainWindowTitle) Next For more information, see Instrução For Each...Next (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" } For more information, see Visão geral sobre inicializadores de coleção (Visual Basic).

Adicionando comentários

Código-fonte nem sempre é explicativa self-, mesmo para o programador que o escreveu. Para ajudar a documentar o seu código, portanto, a maioria dos programadores utilizar liberal 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ário começam com um apóstrofo (') ou REM seguido de um espaço. Eles podem ser adicionados em qualquer lugar no código, exceto dentro de uma seqüência. Para acrescentar um comentário para uma demonstrativo, insira um apóstrofo ou REM após a demonstrativo, seguido do comentário. Comentários também podem ir em seus próprios separada de linha. 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 Errosde compilação

Se, após você digitar uma linha de código, a linha é exibida com um sublinhado ondulado azul (uma mensagem de erro pode aparecer), há um erro de sintaxe na demonstrativo. Você deve descobrir o que há de errado com a demonstrativo (por procurando em uma lista de tarefa , ou focalizando o erro com oponteiro do mousee ler a mensagem de erro ) e corrigi-lo. Até que você resolveu todos os erros de sintaxe em seu código, seu programa não será compilar corretamente.

Related Sections

Term	Definition
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 demonstrativo de várias linhas e coloque várias declarações na mesma linha.
Como: Rotular instruções (Visual Basic)	Mostra como o rótulo uma linha de código.