Delegate.Combine Méthode

Définition

Concatène les listes d'appel des délégués multicast (pouvant être combinés) spécifiés.

Surcharges

Combine(Delegate[])

Concatène les listes d'appel d'un tableau de délégués.

Combine(Delegate, Delegate)

Concatène les listes d'appel de deux délégués.

Combine(Delegate[])

Concatène les listes d'appel d'un tableau de délégués.

public:
 static Delegate ^ Combine(... cli::array <Delegate ^> ^ delegates);
public:
 static Delegate ^ Combine(cli::array <Delegate ^> ^ delegates);
public static Delegate Combine (params Delegate[] delegates);
public static Delegate? Combine (params Delegate?[]? delegates);
public static Delegate Combine (Delegate[] delegates);
[System.Runtime.InteropServices.ComVisible(true)]
public static Delegate Combine (params Delegate[] delegates);
static member Combine : Delegate[] -> Delegate
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Combine : Delegate[] -> Delegate
Public Shared Function Combine (ParamArray delegates As Delegate()) As Delegate
Public Shared Function Combine (delegates As Delegate()) As Delegate

Paramètres

delegates
Delegate[]

Tableau de délégués à combiner.

Retours

Nouveau délégué avec une liste d’invocation qui concatène les listes d’invocation des délégués dans le tableau delegates. Retourne null si delegates est null, si delegates contient zéro élément ou si chaque entrée de delegates est null.

Attributs

Exceptions

Les entrées non null dans delegates ne sont pas toutes des instances du même type de délégué.

Remarques

Si le delegates tableau contient des entrées qui sont null, ces entrées sont ignorées.

La liste d’appels peut contenir des entrées en double ; c’est-à-dire des entrées qui font référence à la même méthode sur le même objet.

Notes

Les délégués génériques compatibles avec les affectations en raison de la variance ne sont pas nécessairement combinables. Pour être combinables, les types doivent correspondre exactement. Par exemple, supposons qu’une classe nommée Derived soit dérivée d’une classe nommée Base. Un délégué de type Action<Base> (Action(Of Base) en Visual Basic) peut être affecté à une variable de type Action<Derived>, comme expliqué dans Covariance et Contravariance, mais les deux délégués ne peuvent pas être combinés, car les types ne correspondent pas exactement.

Combine est utile pour créer des gestionnaires d’événements qui appellent plusieurs méthodes chaque fois qu’un événement se produit.

Voir aussi

S’applique à

Combine(Delegate, Delegate)

Concatène les listes d'appel de deux délégués.

public:
 static Delegate ^ Combine(Delegate ^ a, Delegate ^ b);
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

Paramètres

a
Delegate

Délégué dont la liste d’appel est la première.

b
Delegate

Délégué dont la liste d’appel est la dernière.

Retours

Nouveau délégué avec une liste d’appel qui concatène les listes d’appel de a et b, dans cet ordre. Retourne a si b est null, retourne b si a est une référence null, et retourne une référence null si a et b sont des références null.

Exceptions

a et b ne sont ni l’un ni l’autre null, et a et b ne sont pas des instances du même type délégué.

Remarques

La liste d’appels peut contenir des entrées en double ; c’est-à-dire des entrées qui font référence à la même méthode sur le même objet.

Notes

Les délégués génériques compatibles avec les affectations en raison de la variance ne sont pas nécessairement combinables. Pour être combinables, les types doivent correspondre exactement. Par exemple, supposons qu’une classe nommée Derived soit dérivée d’une classe nommée Base. Un délégué de type Action<Base> (Action(Of Base) en Visual Basic) peut être affecté à une variable de type Action<Derived>, comme expliqué dans Covariance et Contravariance, mais les deux délégués ne peuvent pas être combinés, car les types ne correspondent pas exactement.

Combine est utile pour créer des gestionnaires d’événements qui appellent plusieurs méthodes chaque fois qu’un événement se produit.

Voir aussi

S’applique à