Função Opção

Artigo
08/25/2010

Avalia uma lista de expressões e retorna um valor Object corrspndendo à primeira expressão na lista que é True.

Public Function Switch( _
    ByVal ParamArray VarExpr() As Object _
) As Object

Parâmetros

VarExpr
Obrigatório.Object matriz de parâmetro. Precisa ter um número par de elementos.Você pode fornecer uma lista de variáveis Object ou expressões separadas por vírgulas, ou uma matriz unidimensional de elementos Object.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Número de argumentos é ímpar.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

O argumento fornecido a VarExpr consiste de expressões emparelhadas e valores.A função Switch avalia as expressões de número ímpar do menor para o maior índice em VarExpr, e retorna o valor de número par associado à primeira expressão que avalia para True.Por exemplo, se VarExpr(0) é True, Switch retorna VarExpr(1) e se VarExpr(0) for False mas VarExpr(2) for True, Switch retorna VarExpr(3) e assim por diante.

Se você não fornecer o argumento VarExpr, Switch retorna Nothing.

Observação:
As expressões na lista de argumentos podem incluir chamadas de função.sistema autônomo parte da preparação da lista de argumentos para a telefonar Switch, o compilador do Visual Basic chama cada função em cada expressão. Isso significa que você não pode contar com uma função particular que não é chamada se uma expressão anterior na lista de argumentos é True.

Exemplo

O exemplo a seguir usa a função Switch para retornar o nome de uma linguagem que coincida com o nome de uma cidade.Isso requer que Option Strict seja Off.

Function matchLanguage(ByVal cityName As String) As String
    Return CStr(Microsoft.VisualBasic.Switch( _
        cityName = "London", "English", _
        cityName = "Rome", "Italian", _
        cityName = "Paris", "French"))
End Function

Devido ao fato de que namespace System.Diagnostics també contém uma classe chamada Switch, uma chamada à função Switch deve ser qualificada com o namespace Microsoft.VisualBasic.