Partilhar via

Como: Sobrecarregar um procedimento que leva 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 "Implicit Overloads for a ParamArray Parameter" 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 do 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 de nenhum 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 nem a palavra-chave nem a OptionalParamArray palavra-chave nesta versão sobrecarregada.

  4. Em cada declaração, preceda a Sub palavra-chave 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. Encerre cada procedimento com a End Sub declaração 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 que se seguem ilustram este facto.

' 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. Visual Basic passa o controle para a versão correspondente à 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, não é possível 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 um array que pode ser indefinidamente grande, há um risco de exceder alguma capacidade interna do seu 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 executar as etapas apropriadas se ela for muito grande para seu aplicativo.

Consulte também