Control.BeginInvoke, méthode (Delegate, Object[])

public IAsyncResult BeginInvoke(
	Delegate method,
	params Object[] args
)

Implémentations

Appel asynchrone au délégué et retour immédiat de cette méthode. Vous pouvez appeler cette méthode à partir de n'importe quel thread, même celui qui détient le handle du contrôle. Si le handle du contrôle n'existe pas encore, cette méthode effectuera une recherche dans la chaîne parente du contrôle jusqu'à ce qu'elle trouve un contrôle ou un formulaire avec un handle de fenêtre. Si aucun handle approprié n'est trouvé, BeginInvoke lèvera une exception. Les exceptions au sein de la méthode Delegate sont considérées comme non interceptées et sont envoyées au gestionnaire d'exceptions non interceptées de l'application.

Vous pouvez si nécessaire appeler EndInvoke pour récupérer la valeur de retour du délégué, mais ce n'est pas obligatoire. EndInvoke se bloquera jusqu'à ce que la valeur de retour puisse être extraite.

Remarque

La plupart des méthodes sur un contrôle peuvent être appelées uniquement à partir du thread dans lequel le contrôle a été créé. Outre la propriété InvokeRequired, il existe quatre méthodes sur un contrôle qui sont thread-safe : Invoke, BeginInvoke, EndInvoke et CreateGraphics si le handle du contrôle a déjà été créé. L'appel de CreateGraphics avant la création du handle du contrôle sur un thread d'arrière-plan peut entraîner des appels inter-threads illégaux. Pour tous les autres appels de méthode, vous devez utiliser l'une des méthodes Invoke pour marshaler l'appel au thread du contrôle. Les méthodes invoke appellent toujours leurs rappels sur le thread du contrôle.

Remarque
Une exception peut être levée si le thread qui doit traiter le message n'est plus actif.

L'exemple de code suivant illustre une utilisation de la méthode BeginInvoke.

public delegate void MyDelegate(Label myControl, string myArg2);

private void Button_Click(object sender, EventArgs e)
{
   object[] myArray = new object[2];

   myArray[0] = new Label();
   myArray[1] = "Enter a Value";
   myTextBox.BeginInvoke(new MyDelegate(DelegateMethod), myArray);
}

public void DelegateMethod(Label myControl, string myCaption)
{
   myControl.Location = new Point(16,16);
   myControl.Size = new Size(80, 25);
   myControl.Text = myCaption;
   this.Controls.Add(myControl);
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources