Lire en anglais

Partager via


Delegate.Combine Méthode

Définition

Concatène les listes d’appel des délégués de multidiffusion (combinables) spécifiés.

Surcharges

Combine(Delegate[])

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

Combine(ReadOnlySpan<Delegate>)

Concatène les listes d’appel d’une étendue de délégués.

Combine(Delegate, Delegate)

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

Combine(Delegate[])

Source:
Delegate.cs
Source:
Delegate.cs
Source:
Delegate.cs

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

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

Paramètres

delegates
Delegate[]

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

Retours

Nouveau délégué avec une liste d’appel qui concatène les listes d’appel 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 dans delegates est null.

Attributs

Exceptions

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

Remarques

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

La liste d’appels peut contenir des entrées en double ; autrement dit, les 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 est 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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Combine(ReadOnlySpan<Delegate>)

Concatène les listes d’appel d’une étendue de délégués.

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

Paramètres

delegates
ReadOnlySpan<Delegate>

Étendue des délégués à combiner.

Retours

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

S’applique à

.NET 9
Produit Versions
.NET 9

Combine(Delegate, Delegate)

Source:
Delegate.cs
Source:
Delegate.cs
Source:
Delegate.cs

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

Paramètres

a
Delegate

Délégué dont la liste d’appels vient en premier.

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 de 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 les deux a et b sont des références Null.

Exceptions

Les a et les b ne sont pas 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 ; autrement dit, les 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 est 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 à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0