Operator-Anweisung

Deklariert Symbol, Operanden und Code eines Operators, die eine Operatorprozedur für eine Klasse oder Struktur definieren.

[ <attrlist> ] Public [ Overloads ] Shared [ Shadows ] [ Widening | Narrowing ] 
Operator operatorsymbol ( operand1 [, operand2 ]) [ As [ <attrlist> ] type ]
    [ statements ]
    [ statements ]
    Return returnvalue
    [ statements ]
End Operator

Bestandteile

• attrlist
  Optional. Siehe Attributliste.

• Public
  Erforderlich. Gibt an, dass diese Operatorprozedur Public (Visual Basic)-Zugriff aufweist.

• Overloads
  Optional. Siehe Overloads (Visual Basic).

• Shared
  Erforderlich. Gibt an, dass die Operatorprozedur eine Shared (Visual Basic)-Prozedur ist.

• Shadows
  Optional. Siehe Shadows (Visual Basic).

• Widening
  Für einen Konvertierungsoperator erforderlich, es sei denn, Sie geben Narrowing an. Gibt an, dass die Operatorprozedur eine Widening (Visual Basic)-Konvertierung definiert. Siehe "Erweiterungs- und Eingrenzungskonvertierungen" auf dieser Hilfeseite.

• Narrowing
  Für einen Konvertierungsoperator erforderlich, es sei denn, Sie geben Widening an. Gibt an, dass die Operatorprozedur eine Narrowing (Visual Basic)-Konvertierung definiert. Siehe "Erweiterungs- und Eingrenzungskonvertierungen" auf dieser Hilfeseite.

• operatorsymbol
  Erforderlich. Das Symbol oder der Bezeichner des Operators, das bzw. der diese Operatorprozedur definiert.

• operand1
  Erforderlich. Der Name und Typ des einzigen Operanden eines unären Operators (einschließlich eines Konvertierungsoperators) oder des linken Operanden eines binären Operators.

• operand2
  Für binäre Operatoren erforderlich. Der Name und Typ des rechten Operanden eines binären Operators.

  operand1 und operand2 weisen folgende Syntax und Bestandteile auf:

  [ ByVal ] operandname [ As operandtype ]

  Bestandteil	Beschreibungen
  ByVal	Optional, doch der Übergabemechanismus muss ByVal (Visual Basic) sein.
  operandname	Erforderlich. Name der Variablen, die den Operanden darstellt. Siehe Namen deklarierter Elemente (Visual Basic).
  operandtype	Optional, sofern Option Strict nicht On ist. Datentyp dieses Operanden.

• type
  Optional, sofern Option Strict nicht On ist. Datentyp des Werts, der von der Operatorprozedur zurückgegeben wird.

• statements
  Optional. Block von Anweisungen, die von der Operatorprozedur ausgeführt werden.

• returnvalue
  Erforderlich. Der Wert, den die Operatorprozedur an den aufrufenden Code zurückgibt.

• EndOperator
  Erforderlich. Beendet die Definition dieser Operatorprozedur.

Hinweise

Sie können Operator nur in einer Klasse oder einer Struktur verwenden. Daher kann der Deklarationskontext für einen Operator keine Quelldatei, kein Namespace, kein Modul, keine Schnittstelle, keine Prozedur und kein Block sein. Weitere Informationen finden Sie unter Deklarationskontexte und Standardzugriffsebenen (Visual Basic).

Alle Konvertierungen müssen Public Shared sein. Sie können für beide Operanden nicht ByRef, Optional oder ParamArray angeben.

Sie können das Operatorsymbol oder den Operatorbezeichner nicht zum Speichern eines Rückgabewerts verwenden. Sie müssen die Return-Anweisung verwenden, in der ein Wert angegeben werden muss. In der Prozedur können beliebig viele Return-Anweisungen an beliebiger Stelle vorkommen.

Das Definieren eines Operators auf diese Weise wird als Operatorüberladung bezeichnet, unabhängig davon, ob Sie das Overloads-Schlüsselwort verwenden. In der folgenden Tabelle werden die Operatoren aufgelistet, die Sie definieren können.

Beachten Sie, dass der Operator = in der Liste binärer Operatoren der Vergleichsoperator und nicht der Zuweisungsoperator ist.

Wenn Sie CType definieren, müssen Sie entweder Widening oder Narrowing angeben.

Zueinander passende Paare

Sie müssen bestimmte Operatoren als zueinander passende Paare definieren. Wenn Sie den einen Operator eines solchen Paars definieren, müssen Sie den anderen ebenso definieren. Die zueinander passenden Paare lauten wie folgt:

• = und <>

• > und <

• >= und <=

• IsTrue und IsFalse

Datentypeinschränkungen

Jeder Operator, den Sie definieren, muss die Klasse oder die Struktur umfassen, für die Sie ihn definieren. Dies bedeutet, dass die Klasse oder Struktur als Datentyp eines der folgenden Elemente angegeben werden muss:

• Des Operanden eines unären Operators

• Mindestens eines Operanden eines binären Operators

• Entweder des Operanden oder des Rückgabetyps eines Konvertierungsoperators

Für bestimmte Operatoren gelten zusätzliche Datentypeinschränkungen:

• Wenn Sie den Operator IsTrue und den Operator IsFalse definieren, müssen beide den Boolean-Typ zurückgeben.

• Wenn Sie den Operator << und den Operator >> definieren, müssen beide für den operandtype von operand2 den Integer-Typ angeben.

Der Rückgabetyp muss nicht dem Typ eines der beiden Operanden entsprechen. Beispielsweise kann ein Vergleichsoperator wie = oder <> den Typ Boolean zurückgeben, auch wenn keiner der Operanden vom Typ Boolean ist.

Logische und bitweise Operatoren

Die Operanden And, Or, Not und Xor können in Visual Basic logische oder bitweise Operationen ausführen. Wenn Sie einen dieser Operatoren für eine Klasse oder Struktur definieren, können Sie jedoch nur dessen bitweise Operation definieren.

Sie können den Operator AndAlso nicht direkt für eine Operator-Anweisung definieren. Sie können jedoch AndAlso verwenden, wenn Sie die folgenden Bedingungen erfüllt haben:

• Sie haben And mit den gleichen Operandentypen definiert, die Sie für AndAlso verwenden möchten.

• Die Definition von And gibt denselben Typ wie die Klasse oder Struktur zurück, in der Sie den Operator definiert haben.

• Sie haben den Operator IsFalse in der Klasse oder Struktur definiert, in der Sie And definiert haben.

Ebenso können Sie OrElse verwenden, wenn Sie Or mit denselben Operanden und dem Rückgabetyp der Klasse oder Struktur und für die Klasse oder Struktur IsTrue definiert haben.

Erweiterungs- und Eingrenzungskonvertierungen

Eine erweiternde Konvertierung ist zur Laufzeit immer erfolgreich, während eine einschränkende Konvertierung zur Laufzeit fehlschlagen kann. Weitere Informationen finden Sie unter Erweiternde und eingrenzende Konvertierungen (Visual Basic).

Wenn Sie eine Konvertierungsprozedur als Widening deklarieren, darf der Prozedurcode keine Fehler generieren. Dies bedeutet Folgendes:

• Der Code muss immer einen gültigen Wert vom Typ type zurückgeben.

• Er muss alle möglichen Ausnahmen und andere Fehlerbedingungen behandeln.

• Er muss jeden zurückgegebenen Fehler von jeder Prozedur behandeln, die er aufruft.

Wenn die Möglichkeit besteht, dass eine Konvertierungsprozedur fehlschlägt oder eine nicht behandelte Ausnahme verursacht, müssen Sie sie als Narrowing deklarieren.

Beispiel

Im folgenden Codebeispiel wird die Operator-Anweisung verwendet, um die Gliederung einer Struktur zu definieren, die Operatorprozeduren für die Operatoren And, Or, IsFalse und IsTrue enthält. And und Or akzeptieren jeweils zwei Operanden vom Typ abc mit dem Rückgabetyp abc. IsFalse und IsTrue akzeptieren jeweils einen einzigen Operanden vom Typ abc und geben Boolean zurück. Mit diesen Definitionen kann im aufrufenden Code And, AndAlso, Or und OrElse mit Operanden vom Typ abc verwendet werden.

Public Structure abc
    Dim d As Date
    Public Shared Operator And(ByVal x As abc, ByVal y As abc) As abc
        Dim r As New abc
        ' Insert code to calculate And of x and y.
        Return r
    End Operator
    Public Shared Operator Or(ByVal x As abc, ByVal y As abc) As abc
        Dim r As New abc
        ' Insert code to calculate Or of x and y.
        Return r
    End Operator
    Public Shared Operator IsFalse(ByVal z As abc) As Boolean
        Dim b As Boolean
        ' Insert code to calculate IsFalse of z.
        Return b
    End Operator
    Public Shared Operator IsTrue(ByVal z As abc) As Boolean
        Dim b As Boolean
        ' Insert code to calculate IsTrue of z.
        Return b
    End Operator
End Structure

Siehe auch

Aufgaben

Gewusst wie: Definieren eines Operators (Visual Basic)

Gewusst wie: Definieren eines Konvertierungsoperators (Visual Basic)

Gewusst wie: Aufrufen einer Operatorprozedur (Visual Basic)

Gewusst wie: Verwenden einer Klasse, die Operatoren definiert (Visual Basic)

Referenz

IsFalse-Operator (Visual Basic)

IsTrue-Operator (Visual Basic)

Widening (Visual Basic)

Narrowing (Visual Basic)

Konzepte

Erweiternde und eingrenzende Konvertierungen (Visual Basic)

Operatorprozeduren (Visual Basic)