Compartilhar via

Como sobrecarregar um procedimento que usa um número indefinido de parâmetros (Visual Basic)

Se um procedimento tiver um parâmetro ParamArray , você não poderá definir uma versão sobrecarregada usando uma matriz unidimensional para a matriz de parâmetros. Para obter mais informações, consulte "Sobrecargas implícitas para um parâmetro ParamArray" em considerações sobre procedimentos de sobrecarga.

Para sobrecarregar um procedimento que usa um número variável de parâmetros

  1. Verifique se o procedimento e a lógica de código de chamada se beneficiam mais de versões sobrecarregadas do que de um ParamArray parâmetro. Consulte "Sobrecargas e ParamArrays" em Considerações sobre procedimentos de sobrecarga.

  2. Determine quais números de valores fornecidos o procedimento deve aceitar na parte variável da lista de parâmetros. Isso pode incluir o caso sem valor e pode incluir o caso de uma única matriz unidimensional.

  3. Para cada número aceitável de valores fornecidos, escreva uma declaração Sub ou Function que defina a lista de parâmetros correspondente. Não use as palavras-chave Optional ou ParamArray nesta versão de sobrecarga.

  4. Em cada declaração, preceda a palavra-chave Sub ou Function com a palavra-chave Overloads.

  5. Após cada declaração, escreva o código de procedimento que deve ser executado quando o código de chamada fornecer valores correspondentes à lista de parâmetros dessa declaração.

  6. Terminar cada procedimento com a instrução End Sub ou End Function conforme apropriado.

Exemplo

O exemplo a seguir mostra um procedimento definido com um parâmetro ParamArray e, em seguida, um conjunto equivalente de procedimentos sobrecarregados.

Sub p(ByVal d As Date, ByVal ParamArray c() As Char)

' The preceding definition is equivalent to the following overloads.
' Overloads Sub p(ByVal d As Date)
' Overloads Sub p(ByVal d As Date, ByVal c() As Char)
' Overloads Sub p(ByVal d As Date, ByVal c1 As Char)
' Overloads Sub p(ByVal d As Date, ByVal c1 As Char, ByVal c2 As Char)
' And so on, with an additional Char argument in each successive overload.

Não é possível sobrecarregar esse procedimento com uma lista de parâmetros que usa uma matriz unidimensional para a matriz de parâmetros. No entanto, você pode usar as assinaturas das outras sobrecargas implícitas. As declarações a seguir ilustram isso.

' The following overload is not valid because it takes an array for the parameter array.
' Overloads Sub p(ByVal x As Date, ByVal y() As Char)
' The following overload takes a single value for the parameter array and is valid.
Overloads Sub p(ByVal z As Date, ByVal w As Char)

O código nas versões sobrecarregadas não precisa testar se o código de chamada forneceu um ou mais valores para o ParamArray parâmetro ou, se for o caso, quantos. O Visual Basic passa o controle para a versão que corresponde à lista de argumentos de chamada.

Compilar o código

Como um procedimento com um ParamArray parâmetro é equivalente a um conjunto de versões sobrecarregadas, você não pode sobrecarregar esse procedimento com uma lista de parâmetros correspondente a qualquer uma dessas sobrecargas implícitas. Para obter mais informações, consulte Considerações sobre procedimentos de sobrecarga.

Segurança do .NET Framework

Sempre que você lida com uma matriz que pode ser indefinidamente grande, há o risco de ultrapassar alguma capacidade interna do aplicativo. Se você aceitar uma matriz de parâmetros, deverá testar o comprimento da matriz que o código de chamada passou para ela e tomar as etapas apropriadas se ela for muito grande para seu aplicativo.

Consulte também