Compartilhar via

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

  • Artigo

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 Sub instrução ou Function declaração que defina a lista de parâmetros correspondente. Não use a palavra-chave ou a OptionalParamArray palavra-chave nesta versão sobrecarregada.

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

  5. Seguindo 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. Encerre cada procedimento com a instrução ou End Sub a End Function instrução 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.

Você não pode 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, em caso afirmativo, 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.

Confira também