Delegate.Combine Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Łączy listy wywołań określonych delegatów multiemisji (połączonych).

Przeciążenia

Nazwa	Opis
Combine(Delegate[])	Łączy listy wywołań tablicy delegatów.
Combine(ReadOnlySpan<Delegate>)	Łączy listy wywołań zakresu delegatów.
Combine(Delegate, Delegate)	Łączy listy wywołań dwóch delegatów.

Combine(Delegate[])

Źródło:

Delegate.cs

Łączy listy wywołań tablicy delegatów.

public:
 static Delegate ^ Combine(... cli::array <Delegate ^> ^ delegates);

public static Delegate? Combine(params Delegate?[]? delegates);

static member Combine : Delegate[] -> Delegate

Public Shared Function Combine (ParamArray delegates As Delegate()) As Delegate

Parametry

delegates

Delegate[]

Tablica delegatów do połączenia.

Zwraca

Delegate

Nowy delegat z listą wywołań, która łączy listy wywołań delegatów w tablicy delegates . Zwraca null wartość if , delegatesjeśli nulldelegates zawiera zero elementów, lub jeśli każdy wpis w delegates pliku to null.

Wyjątki

ArgumentException

Nie wszystkie wpisy inne niż null w programie delegates są wystąpieniami tego samego typu delegata.

Uwagi

Jeśli tablica delegates zawiera wpisy, które są null, te wpisy są ignorowane.

Lista wywołań może zawierać zduplikowane wpisy; oznacza to, że wpisy odwołujące się do tej samej metody w tym samym obiekcie.

Uwaga

Delegaty ogólne, które są zgodne z przypisaniem ze względu na wariancję, nie muszą być połączone. Aby można je było połączyć, typy muszą być dokładnie zgodne. Załóżmy na przykład, że klasa o nazwie Derived pochodzi z klasy o nazwie Base. Delegat typu Action<Base> (Action(Of Base) w Visual Basic) można przypisać do zmiennej typu Action<Derived>, zgodnie z opisem w Kovariance i Contravariance ale dwa delegaty nie mogą być łączone, ponieważ typy nie są dokładnie zgodne.

Combine jest przydatny do tworzenia programów obsługi zdarzeń, które są wywoływane wiele metod za każdym razem, gdy wystąpi zdarzenie.

Zobacz też

• MulticastDelegate
• CombineImpl(Delegate)

Combine(ReadOnlySpan<Delegate>)

Źródło:

Delegate.cs

Łączy listy wywołań zakresu delegatów.

public:
 static Delegate ^ Combine(ReadOnlySpan<Delegate ^> delegates);

public static Delegate? Combine(scoped ReadOnlySpan<Delegate?> delegates);

static member Combine : ReadOnlySpan<Delegate> -> Delegate

Public Shared Function Combine (delegates As ReadOnlySpan(Of Delegate)) As Delegate

Parametry

delegates

ReadOnlySpan<Delegate>

Zakres delegatów do połączenia.

Zwraca

Delegate

Nowy delegat z listą wywołań, która łączy listy wywołań delegatów w delegates zakresie. Zwraca null wartość if , delegatesjeśli nulldelegates zawiera zero elementów, lub jeśli każdy wpis w delegates pliku to null.

Combine(Delegate, Delegate)

Źródło:

Delegate.cs

Łączy listy wywołań dwóch delegatów.

public:
 static Delegate ^ Combine(Delegate ^ a, Delegate ^ b);

public static Delegate? Combine(Delegate? a, Delegate? b);

static member Combine : Delegate * Delegate -> Delegate

Public Shared Function Combine (a As Delegate, b As Delegate) As Delegate

Parametry

a

Delegate

Delegat, którego lista wywołań jest pierwsza.

b

Delegate

Delegat, którego lista wywołań jest ostatnia.

Zwraca

Delegate

Nowy delegat z listą wywołań, która łączy listy a wywołań i b w tej kolejności. Zwraca wartość a if , zwraca wartość b , jeśli nullbajest odwołaniem o wartości null i zwraca odwołanie o wartości null, jeśli oba a odwołania mają b wartość null.

Wyjątki

ArgumentException

Zarówno a , jak bnull i a nie bsą i nie są wystąpieniami tego samego typu delegata.

Uwagi

Lista wywołań może zawierać zduplikowane wpisy; oznacza to, że wpisy odwołujące się do tej samej metody w tym samym obiekcie.

Uwaga

Delegaty ogólne, które są zgodne z przypisaniem ze względu na wariancję, nie muszą być połączone. Aby można je było połączyć, typy muszą być dokładnie zgodne. Załóżmy na przykład, że klasa o nazwie Derived pochodzi z klasy o nazwie Base. Delegat typu Action<Base> (Action(Of Base) w Visual Basic) można przypisać do zmiennej typu Action<Derived>, zgodnie z opisem w Kovariance i Contravariance ale dwa delegaty nie mogą być łączone, ponieważ typy nie są dokładnie zgodne.

Combine jest przydatny do tworzenia programów obsługi zdarzeń, które są wywoływane wiele metod za każdym razem, gdy wystąpi zdarzenie.

Zobacz też

• MulticastDelegate
• CombineImpl(Delegate)