Freigeben über

Vorgehensweise: Überladen einer Prozedur, die eine unbegrenzte Anzahl von Parametern (Visual Basic) akzeptiert

Wenn eine Prozedur über einen ParamArray-Parameter verfügt, können Sie keine überladene Version definieren, die eindimensionales Array für das Parameterarray verwendet. Weitere Informationen finden Sie unter "Implizite Überladungen für einen ParamArray-Parameter" in Überlegungen in Überladungsprozeduren.

So überladen Sie eine Prozedur, die eine variable Anzahl von Parametern verwendet

  1. Vergewissern Sie sich, dass die Prozedur und die Logik beim Aufrufen des Codes mehr von überladenen Versionen als von einem ParamArray Parameter profitieren. Weitere Informationen finden Sie unter Überlegungen zur Prozedurüberladung (Visual Basic) im Abschnitt „Overloads and ParamArrays“ (Überladungen und ParamArrays).

  2. Ermitteln Sie, welche Anzahl von angegebenen Werten die Prozedur im variablen Teil der Parameterliste akzeptieren soll. Dies könnte den Fall ohne Wert umfassen, und es könnte den Fall eines einzelnen eindimensionalen Arrays umfassen.

  3. Schreiben Sie für jede zulässige Anzahl von angegebenen Werten eine Deklarationsanweisung vom Typ Sub oder Function, die die entsprechende Parameterliste definiert. Verwenden Sie in dieser überladenen Version weder das Optional Schlüsselwort noch das ParamArray Schlüsselwort.

  4. In jeder Deklaration ist dem Schlüsselwort Sub oder Function das Schlüsselwort Overloads voranzustellen.

  5. Schreiben Sie nach jeder Deklaration den Prozedurcode, der ausgeführt werden soll, wenn der aufrufende Code Werte bereitstellt, die der Parameterliste dieser Deklaration entsprechen.

  6. Beenden Sie jede Prozedur entsprechend entweder mit der End Sub- oder der End Function-Anweisung.

Beispiel

Das folgende Beispiel zeigt eine Prozedur, die mit einem ParamArray-Parameter definiert ist, und dann einen entsprechenden Satz überladener Prozeduren.

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.

Sie können eine solche Prozedur nicht mit einer Parameterliste überladen, die ein eindimensionales Array für das Parameterarray verwendet. Sie können jedoch die Signaturen der anderen impliziten Überladungen verwenden. Die folgenden Deklarationen veranschaulichen dies.

' 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)

Der Code in den überladenen Versionen muss nicht testen, ob der aufrufende Code einen oder mehrere Werte für den ParamArray Parameter bereitgestellt hat, oder wenn ja, wie viele. Visual Basic übergibt die Steuerung an die Version, die der aufrufenden Argumentliste entspricht.

Kompilieren des Codes

Da eine Prozedur mit einem ParamArray Parameter einer Reihe überladener Versionen entspricht, können Sie eine solche Prozedur nicht mit einer Parameterliste überladen, die einer dieser impliziten Überladungen entspricht. Weitere Informationen finden Sie unter Überlegungen zu Überladungsverfahren.

.NET Framework-Sicherheit

Wenn Sie mit einem Array umgehen, das unbegrenzt groß sein kann, besteht das Risiko, dass einige interne Kapazität Ihrer Anwendung überlaufen wird. Wenn Sie ein Parameterarray akzeptieren, sollten Sie die Länge des Arrays testen, das der aufrufende Code übergeben hat, und die entsprechenden Schritte ausführen, wenn es für Ihre Anwendung zu groß ist.

Siehe auch

  • Last updated on