Partilhar via


Matrizes de parâmetro

Normalmente, você não pode telefonar um procedimento com mais argumentos que especifica a declaração de procedimento.Quando você precisar de um número indefinida de argumentos, você pode declarar um matriz de parâmetro, que permite que um procedimento aceitar uma matriz de valores para um parâmetro.Não é necessário saber o número de elementos na matriz de parâmetro quando você define o procedimento.O dimensionar de matriz é determinado individualmente por cada telefonar ao procedimento.

Declarando um ParamArray

Você usa o ParamArray palavra-chave para indicar uma matriz de parâmetro na lista de parâmetros. As seguintes regras se aplicam:

  • Um procedimento pode definir apenas uma matriz de parâmetro e deve ser o último parâmetro na definição do procedimento.

  • A matriz de parâmetro deve ser passada por valor.É recomendável incluir explicitamente o prática de programaçãoByVal palavra-chave na definição do procedimento.

  • A matriz de parâmetro é opcional automaticamente.O valor padrão é uma matriz unidimensional vazia do tipo de elemento da matriz de parâmetro.

  • Todos os parâmetros que precede a matriz de parâmetro devem ser necessários.A matriz de parâmetro deve ser o parâmetro opcional somente.

Para obter mais informações, consulte Como: Definir um procedimento com um número indefinida de parâmetros.

Chamando um ParamArray

Quando você chamar um procedimento que define uma matriz de parâmetro, você pode fornecer o argumento em qualquer uma das seguintes maneiras:

  • Nada — ou seja, você pode omitir o ParamArray argumento. Nesse caso, uma matriz vazia é passada para o procedimento.Você também pode passar o Nada (Visual Basic) palavra-chave, com o mesmo efeito.

  • Uma lista de um número arbitrário de argumentos, separados por vírgulas.O tipo de dados de cada argumento deve ser implicitamente conversível ao tipo de elemento ParamArray.

  • Uma matriz com o mesmo tipo de elemento do tipo de elemento da matriz de parâmetro.

Em todos sistema autônomo casos, o código no procedimento de trata a matriz de parâmetro sistema autônomo uma matriz unidimensional com elementos do mesmo tipo de dados sistema autônomo a ParamArray tipo de dados.

Para obter mais informações, consulte Como: Chamar um procedimento que tem um número indefinida de parâmetros.

Observação de segurança:

Sempre que você lidar com uma matriz que pode ser indefinidamente grande, há um risco de ultrapassar alguma capacidade interna da sua aplicação.Se você aceitar uma matriz de parâmetro, você deve testar o dimensionar da matriz que o código de chamada passado para ele.Execute as etapas apropriadas se ele for muito grande para o seu aplicativo.Para obter mais informações, consulte Como: Determinar o dimensionar de um array.

Consulte também

Conceitos

Procedimentos no Visual Basic

Parâmetros do procedimento e argumentos

Argumento Passing By valor e por referência

Passagem de Argumentos por Posição e Nome

Parâmetros Opcionais

Sobrecarga de procedimento

Verificação de Tipo no Visual Basic

Referência

Opcional (Visual Basic)

Função UBound (Visual Basic)

Outros recursos

Matrizes no Visual Basic