Control.BeginInvoke Méthode

Définition

Exécute un délégué de manière asynchrone sur le thread sur lequel le handle sous-jacent du contrôle a été créé.Executes a delegate asynchronously on the thread that the control's underlying handle was created on.

Surcharges

BeginInvoke(Delegate)

Exécute le délégué spécifié de manière asynchrone sur le thread sur lequel le handle sous-jacent du contrôle a été créé.Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

BeginInvoke(Delegate, Object[])

Exécute le délégué spécifié de manière asynchrone avec les arguments spécifiés, sur le thread sur lequel le handle sous-jacent du contrôle a été créé.Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

BeginInvoke(Delegate)

Exécute le délégué spécifié de manière asynchrone sur le thread sur lequel le handle sous-jacent du contrôle a été créé.Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

public:
 IAsyncResult ^ BeginInvoke(Delegate ^ method);
public IAsyncResult BeginInvoke (Delegate method);
member this.BeginInvoke : Delegate -> IAsyncResult
Public Function BeginInvoke (method As Delegate) As IAsyncResult

Paramètres

method
Delegate

Délégué vers une méthode qui n'accepte pas de paramètres.A delegate to a method that takes no parameters.

Retours

IAsyncResult qui représente le résultat de l'opération BeginInvoke(Delegate).An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

Exceptions

Aucun handle de fenêtre approprié n'a été trouvé.No appropriate window handle can be found.

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode BeginInvoke.The following code example demonstrates a use of the BeginInvoke method.

private:
   void Invoke_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      myTextBox->BeginInvoke( gcnew InvokeDelegate( this, &MyForm::InvokeMethod ) );
   }

   void InvokeMethod()
   {
      myTextBox->Text = "Executed the given delegate";
   }
public delegate void InvokeDelegate();

private void Invoke_Click(object sender, EventArgs e)
{
   myTextBox.BeginInvoke(new InvokeDelegate(InvokeMethod));
}
public void InvokeMethod()
{
   myTextBox.Text = "Executed the given delegate";
}
Delegate Sub InvokeDelegate()

Private Sub Invoke_Click(sender As Object, e As EventArgs)
   myTextBox.BeginInvoke(New InvokeDelegate(AddressOf InvokeMethod))
End Sub

Public Sub InvokeMethod()
   myTextBox.Text = "Executed the given delegate"
End Sub

Remarques

Le délégué est appelé de façon asynchrone et cette méthode est retournée immédiatement.The delegate is called asynchronously, and this method returns immediately. Vous pouvez appeler cette méthode à partir de n’importe quel thread, même le thread qui possède le handle du contrôle.You can call this method from any thread, even the thread that owns the control's handle. Si le handle du contrôle n’existe pas encore, cette méthode effectue une recherche dans la chaîne parente du contrôle jusqu’à ce qu’il trouve un contrôle ou un formulaire qui a un handle de fenêtre.If the control's handle does not exist yet, this method searches up the control's parent chain until it finds a control or form that does have a window handle. Si aucun handle approprié n’est trouvé, BeginInvoke lèvera une exception.If no appropriate handle can be found, BeginInvoke will throw an exception. Les exceptions dans la méthode déléguée sont considérées comme non interceptées et sont envoyées au gestionnaire d’exceptions non interceptées de l’application.Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

Vous pouvez appeler EndInvoke pour récupérer la valeur de retour du délégué, si nécessaires, mais cela n’est pas obligatoire.You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvoke se bloque jusqu’à ce que la valeur de retour puisse être récupérée.EndInvoke will block until the return value can be retrieved.

Notes

La plupart des méthodes sur un contrôle ne peuvent être appelées qu’à partir du thread sur lequel le contrôle a été créé.Most methods on a control can only be called from the thread where the control was created. En plus de la propriété InvokeRequired, il existe quatre méthodes sur un contrôle thread-safe : Invoke, BeginInvoke, EndInvoke et CreateGraphics Si le handle du contrôle a déjà été créé.In addition to the InvokeRequired property, there are four methods on a control that are thread safe: Invoke, BeginInvoke, EndInvoke, and CreateGraphics if the handle for the control has already been created. 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 non conformes.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. 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.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. Les méthodes Invoke appellent toujours leurs rappels sur le thread du contrôle.The invoke methods always invoke their callbacks on the control's thread.

Notes

Une exception peut être levée si le thread qui doit traiter le message n’est plus actif.An exception might be thrown if the thread that should process the message is no longer active.

Sécurité

SecurityPermission
pour que l’appelant immédiat appelle du code non managé.for the immediate caller to call unmanaged code. Énumération associée : UnmanagedCodeAssociated enumeration: UnmanagedCode

Voir aussi

BeginInvoke(Delegate, Object[])

Exécute le délégué spécifié de manière asynchrone avec les arguments spécifiés, sur le thread sur lequel le handle sous-jacent du contrôle a été créé.Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

public:
 virtual IAsyncResult ^ BeginInvoke(Delegate ^ method, cli::array <System::Object ^> ^ args);
public IAsyncResult BeginInvoke (Delegate method, object[] args);
abstract member BeginInvoke : Delegate * obj[] -> IAsyncResult
override this.BeginInvoke : Delegate * obj[] -> IAsyncResult
Public Function BeginInvoke (method As Delegate, args As Object()) As IAsyncResult

Paramètres

method
Delegate

Délégué vers une méthode qui accepte des paramètres du même nombre et du même type que ceux contenus dans le paramètre args.A delegate to a method that takes parameters of the same number and type that are contained in the args parameter.

args
Object[]

Tableau d’objets à passer comme arguments à la méthode donnée.An array of objects to pass as arguments to the given method. Peut être null si aucun argument n’est nécessaire.This can be null if no arguments are needed.

Retours

IAsyncResult qui représente le résultat de l'opération BeginInvoke(Delegate).An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

Implémente

Exceptions

Aucun handle de fenêtre approprié n'a été trouvé.No appropriate window handle can be found.

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode BeginInvoke.The following code example demonstrates a use of the BeginInvoke method.

private:
   delegate void MyDelegate(
   Label^ myControl, String^ myArg2 );
   void Button_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      array<Object^>^myArray = gcnew array<Object^>(2);
      myArray[ 0 ] = gcnew Label;
      myArray[ 1 ] = "Enter a Value";
      myTextBox->BeginInvoke( gcnew MyDelegate( this, &MyForm::DelegateMethod ), myArray );
   }

   void DelegateMethod( Label^ myControl, String^ myCaption )
   {
      myControl->Location = Point(16,16);
      myControl->Size = System::Drawing::Size( 80, 25 );
      myControl->Text = myCaption;
      this->Controls->Add( myControl );
   }

   delegate void InvokeDelegate();
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);
}
Delegate Sub MyDelegate(myControl As Label, myArg2 As String)

Private Sub Button_Click(sender As Object, e As EventArgs)
   Dim myArray(1) As Object
   
   myArray(0) = New Label()
   myArray(1) = "Enter a Value"
   myTextBox.BeginInvoke(New MyDelegate(AddressOf DelegateMethod), myArray)
End Sub

Public Sub DelegateMethod(myControl As Label, myCaption As String)
   myControl.Location = New Point(16, 16)
   myControl.Size = New Size(80, 25)
   myControl.Text = myCaption
   Me.Controls.Add(myControl)
End Sub

Remarques

Le délégué est appelé de façon asynchrone et cette méthode est retournée immédiatement.The delegate is called asynchronously, and this method returns immediately. Vous pouvez appeler cette méthode à partir de n’importe quel thread, même le thread qui possède le handle du contrôle.You can call this method from any thread, even the thread that owns the control's handle. Si le handle du contrôle n’existe pas encore, cette méthode effectue une recherche dans la chaîne parente du contrôle jusqu’à ce qu’il trouve un contrôle ou un formulaire qui a un handle de fenêtre.If the control's handle does not exist yet, this method searches up the control's parent chain until it finds a control or form that does have a window handle. Si aucun handle approprié n’est trouvé, BeginInvoke lèvera une exception.If no appropriate handle can be found, BeginInvoke will throw an exception. Les exceptions dans la méthode déléguée sont considérées comme non interceptées et sont envoyées au gestionnaire d’exceptions non interceptées de l’application.Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

Vous pouvez appeler EndInvoke pour récupérer la valeur de retour du délégué, si nécessaires, mais cela n’est pas obligatoire.You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvoke se bloque jusqu’à ce que la valeur de retour puisse être récupérée.EndInvoke will block until the return value can be retrieved.

Notes

La plupart des méthodes sur un contrôle ne peuvent être appelées qu’à partir du thread sur lequel le contrôle a été créé.Most methods on a control can only be called from the thread where the control was created. En plus de la propriété InvokeRequired, il existe quatre méthodes sur un contrôle thread-safe : Invoke, BeginInvoke, EndInvoke et CreateGraphics Si le handle du contrôle a déjà été créé.In addition to the InvokeRequired property, there are four methods on a control that are thread safe: Invoke, BeginInvoke, EndInvoke, and CreateGraphics if the handle for the control has already been created. 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 non conformes.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. 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.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. Les méthodes Invoke appellent toujours leurs rappels sur le thread du contrôle.The invoke methods always invoke their callbacks on the control's thread.

Notes

Une exception peut être levée si le thread qui doit traiter le message n’est plus actif.An exception might be thrown if the thread that should process the message is no longer active.

Voir aussi

S’applique à