Control.BeginInvoke Control.BeginInvoke Control.BeginInvoke Control.BeginInvoke Method

Definition

Führt einen Delegaten asynchron für den Thread aus, in dem das dem Steuerelement zugrunde liegende Handle erstellt wurde.Executes a delegate asynchronously on the thread that the control's underlying handle was created on.

Überlädt

BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate)

Führt den angegebenen Delegaten asynchron für den Thread aus, in dem das dem Steuerelement zugrunde liegende Handle erstellt wurde.Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[])

Führt den angegebenen Delegaten asynchron mit den angegebenen Argumenten für den Thread aus, in dem das diesem Steuerelement zugrunde liegende Handle erstellt wurde.Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate)

Führt den angegebenen Delegaten asynchron für den Thread aus, in dem das dem Steuerelement zugrunde liegende Handle erstellt wurde.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

Parameter

method
Delegate Delegate Delegate Delegate

Ein Delegat für eine Methode, die keine Parameter annimmt.A delegate to a method that takes no parameters.

Gibt zurück

Ein IAsyncResult-Objekt, das das Ergebnis der BeginInvoke(Delegate)-Operation darstellt.An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

Ausnahmen

Es kann kein entsprechendes Fensterhandle gefunden werden.No appropriate window handle can be found.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, eine Verwendung von der BeginInvoke Methode.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 'Invoke_Click

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

Hinweise

Der Delegat wird asynchron aufgerufen, und diese Methode wird sofort zurückgegeben.The delegate is called asynchronously, and this method returns immediately. Sie können diese Methode von jedem Thread, einschließlich des Threads aus aufrufen, die das Handle des Steuerelements besitzt.You can call this method from any thread, even the thread that owns the control's handle. Wenn das Handle des Steuerelements noch nicht vorhanden ist, durchsucht diese Methode Kette übergeordneter des Steuerelements bis zu einem Steuerelement oder Formular, die ein Fensterhandle besitzt.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. Wenn kein entsprechendes Handle gefunden werden kann, BeginInvoke wird eine Ausnahme ausgelöst.If no appropriate handle can be found, BeginInvoke will throw an exception. Ausnahmen in die Delegatmethode gelten als nicht abgefangen und an der Anwendung nicht abgefangene Ausnahme-Handler gesendet werden.Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

Rufen Sie EndInvoke den Rückgabewert aus dem Delegaten abgerufen werden, wenn erforderlich, aber dies ist nicht erforderlich.You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvoke blockiert, bis der zurückgegebene Wert abgerufen werden kann.EndInvoke will block until the return value can be retrieved.

Hinweis

Die meisten Methoden für ein Steuerelement können nur aus dem Thread aufgerufen werden, wo das Steuerelement erstellt wurde.Most methods on a control can only be called from the thread where the control was created. Zusätzlich zu den InvokeRequired -Eigenschaft, es gibt vier Methoden für ein Steuerelement, die threadsicher sind: Invoke, BeginInvoke, EndInvoke, und CreateGraphics , wenn das Handle für das Steuerelement bereits erstellt wurde.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. Aufrufen von CreateGraphics vor dem das Handle des Steuerelements in einem Hintergrundthread erstellt wurde können dazu führen, dass unzulässigen threadübergreifenden aufrufen.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. Für alle anderen Aufrufe sollten Sie eine der Invoke-Methoden verwenden, den Aufruf des Steuerelements Thread zu marshallen.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. Die Invoke-Methoden rufen Sie immer die Rückrufe im Thread des Steuerelements.The invoke methods always invoke their callbacks on the control's thread.

Hinweis

Eine Ausnahme kann ausgelöst werden, wenn der Thread, der die Nachricht zu verarbeiten, sollten nicht mehr aktiv ist.An exception might be thrown if the thread that should process the message is no longer active.

Sicherheit

SecurityPermission
für den unmittelbaren Aufrufer nicht verwalteten Code aufrufen.for the immediate caller to call unmanaged code. Zugeordnete Enumeration: UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[])

Führt den angegebenen Delegaten asynchron mit den angegebenen Argumenten für den Thread aus, in dem das diesem Steuerelement zugrunde liegende Handle erstellt wurde.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, params object[] args);
abstract member BeginInvoke : Delegate * obj[] -> IAsyncResult
override this.BeginInvoke : Delegate * obj[] -> IAsyncResult
Public Function BeginInvoke (method As Delegate, ParamArray args As Object()) As IAsyncResult

Parameter

method
Delegate Delegate Delegate Delegate

Ein Delegat einer Methode, der Parameter derselben Anzahl und desselben Typs der im args-Parameter enthaltenen Parameter annimmt.A delegate to a method that takes parameters of the same number and type that are contained in the args parameter.

args
Object[]

Ein Array von Objekten, die als Argumente an die angegebene Methode übergeben werden sollen.An array of objects to pass as arguments to the given method. Dies kann null sein, wenn keine Argumente benötigt werden.This can be null if no arguments are needed.

Gibt zurück

Ein IAsyncResult-Objekt, das das Ergebnis der BeginInvoke(Delegate)-Operation darstellt.An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

Implementiert

Ausnahmen

Es kann kein entsprechendes Fensterhandle gefunden werden.No appropriate window handle can be found.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, eine Verwendung von der BeginInvoke Methode.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 'Button_Click

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 'DelegateMethod

Hinweise

Der Delegat wird asynchron aufgerufen, und diese Methode wird sofort zurückgegeben.The delegate is called asynchronously, and this method returns immediately. Sie können diese Methode von jedem Thread, einschließlich des Threads aus aufrufen, die das Handle des Steuerelements besitzt.You can call this method from any thread, even the thread that owns the control's handle. Wenn das Handle des Steuerelements noch nicht vorhanden ist, durchsucht diese Methode Kette übergeordneter des Steuerelements bis zu einem Steuerelement oder Formular, die ein Fensterhandle besitzt.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. Wenn kein entsprechendes Handle gefunden werden kann, BeginInvoke wird eine Ausnahme ausgelöst.If no appropriate handle can be found, BeginInvoke will throw an exception. Ausnahmen in die Delegatmethode gelten als nicht abgefangen und an der Anwendung nicht abgefangene Ausnahme-Handler gesendet werden.Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

Rufen Sie EndInvoke den Rückgabewert aus dem Delegaten abgerufen werden, wenn erforderlich, aber dies ist nicht erforderlich.You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvoke blockiert, bis der zurückgegebene Wert abgerufen werden kann.EndInvoke will block until the return value can be retrieved.

Hinweis

Die meisten Methoden für ein Steuerelement können nur aus dem Thread aufgerufen werden, wo das Steuerelement erstellt wurde.Most methods on a control can only be called from the thread where the control was created. Zusätzlich zu den InvokeRequired -Eigenschaft, es gibt vier Methoden für ein Steuerelement, die threadsicher sind: Invoke, BeginInvoke, EndInvoke, und CreateGraphics , wenn das Handle für das Steuerelement bereits erstellt wurde.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. Aufrufen von CreateGraphics vor dem das Handle des Steuerelements in einem Hintergrundthread erstellt wurde können dazu führen, dass unzulässigen threadübergreifenden aufrufen.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. Für alle anderen Aufrufe sollten Sie eine der Invoke-Methoden verwenden, den Aufruf des Steuerelements Thread zu marshallen.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. Die Invoke-Methoden rufen Sie immer die Rückrufe im Thread des Steuerelements.The invoke methods always invoke their callbacks on the control's thread.

Hinweis

Eine Ausnahme kann ausgelöst werden, wenn der Thread, der die Nachricht zu verarbeiten, sollten nicht mehr aktiv ist.An exception might be thrown if the thread that should process the message is no longer active.

Siehe auch

Gilt für: