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

Definizione

Esegue in modo asincrono un delegato nel thread in cui è stato creato il punto di controllo sottostante del controllo.Executes a delegate asynchronously on the thread that the control's underlying handle was created on.

Overload

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

Esegue in modo asincrono il delegato specificato nel thread in cui è stato creato il punto di controllo sottostante del controllo.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[])

Esegue in modo asincrono il delegato specificato con gli argomenti specificati nel thread in cui è stato creato il punto di controllo sottostante del controllo.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)

Esegue in modo asincrono il delegato specificato nel thread in cui è stato creato il punto di controllo sottostante del controllo.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

Parametri

method
Delegate Delegate Delegate Delegate

Delegato di un metodo che non accetta parametri.A delegate to a method that takes no parameters.

Restituisce

Oggetto IAsyncResult che rappresenta il risultato dell'operazione BeginInvoke(Delegate).An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

Eccezioni

Non Impossibile trovare un alcun handle di finestra appropriato.No appropriate window handle can be found.

Esempi

Esempio di codice seguente viene illustrato un utilizzo di BeginInvoke (metodo).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

Commenti

Il delegato viene chiamato in modo asincrono e questo metodo viene restituito immediatamente.The delegate is called asynchronously, and this method returns immediately. È possibile chiamare questo metodo da qualsiasi thread, anche il thread che possiede l'handle del controllo.You can call this method from any thread, even the thread that owns the control's handle. Se l'handle del controllo non esiste ancora, questo metodo cerca catena padre del controllo finché non trova un controllo o form che dispone di un handle di finestra.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. Se non viene trovato alcun handle appropriato, BeginInvoke genererà un'eccezione.If no appropriate handle can be found, BeginInvoke will throw an exception. Le eccezioni all'interno del metodo delegato sono considerate non intercettate e verrà inviato al gestore dell'eccezione non intercettata dell'applicazione.Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

È possibile chiamare EndInvoke per recuperare il valore restituito dal delegato, se necessario, ma questo non è obbligatorio.You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvoke blocca fino a quando il valore restituito può essere recuperato.EndInvoke will block until the return value can be retrieved.

Nota

La maggior parte dei metodi su un controllo possono essere chiamati solo dal thread in cui è stato creato il controllo.Most methods on a control can only be called from the thread where the control was created. Oltre al InvokeRequired proprietà, sono disponibili quattro metodi su un controllo che sono thread-safe: Invoke, BeginInvoke, EndInvoke, e CreateGraphics se l'handle per il controllo è già stato creato.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. La chiamata a CreateGraphics prima che venga creato l'handle del controllo in un thread in background può causare valido chiamate tra thread.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. Per tutte le altre chiamate di metodo, è consigliabile usare uno dei metodi invoke per effettuare il marshalling della chiamata al thread del controllo.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. I metodi invoke richiamano sempre il callback sul thread del controllo.The invoke methods always invoke their callbacks on the control's thread.

Nota

Potrebbe essere generata un'eccezione se il thread che debba elaborare il messaggio non è più attivo.An exception might be thrown if the thread that should process the message is no longer active.

Sicurezza

SecurityPermission
per il chiamante immediato chiamare codice non gestito.for the immediate caller to call unmanaged code. Enumerazione associata: UnmanagedCodeAssociated enumeration: UnmanagedCode

Vedi anche

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

Esegue in modo asincrono il delegato specificato con gli argomenti specificati nel thread in cui è stato creato il punto di controllo sottostante del controllo.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

Parametri

method
Delegate Delegate Delegate Delegate

Delegato di un metodo che accetta parametri dello stesso tipo e numero contenuti nel parametro args.A delegate to a method that takes parameters of the same number and type that are contained in the args parameter.

args
Object[]

Matrice di oggetti da passare come argomenti al metodo specificato.An array of objects to pass as arguments to the given method. Se non sono richiesti argomenti, può corrispondere a null.This can be null if no arguments are needed.

Restituisce

Oggetto IAsyncResult che rappresenta il risultato dell'operazione BeginInvoke(Delegate).An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

Implementazioni

Eccezioni

Non Impossibile trovare un alcun handle di finestra appropriato.No appropriate window handle can be found.

Esempi

Esempio di codice seguente viene illustrato un utilizzo di BeginInvoke (metodo).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

Commenti

Il delegato viene chiamato in modo asincrono e questo metodo viene restituito immediatamente.The delegate is called asynchronously, and this method returns immediately. È possibile chiamare questo metodo da qualsiasi thread, anche il thread che possiede l'handle del controllo.You can call this method from any thread, even the thread that owns the control's handle. Se l'handle del controllo non esiste ancora, questo metodo cerca catena padre del controllo finché non trova un controllo o form che dispone di un handle di finestra.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. Se non viene trovato alcun handle appropriato, BeginInvoke genererà un'eccezione.If no appropriate handle can be found, BeginInvoke will throw an exception. Le eccezioni all'interno del metodo delegato sono considerate non intercettate e verrà inviato al gestore dell'eccezione non intercettata dell'applicazione.Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

È possibile chiamare EndInvoke per recuperare il valore restituito dal delegato, se necessario, ma questo non è obbligatorio.You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvoke blocca fino a quando il valore restituito può essere recuperato.EndInvoke will block until the return value can be retrieved.

Nota

La maggior parte dei metodi su un controllo possono essere chiamati solo dal thread in cui è stato creato il controllo.Most methods on a control can only be called from the thread where the control was created. Oltre al InvokeRequired proprietà, sono disponibili quattro metodi su un controllo che sono thread-safe: Invoke, BeginInvoke, EndInvoke, e CreateGraphics se l'handle per il controllo è già stato creato.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. La chiamata a CreateGraphics prima che venga creato l'handle del controllo in un thread in background può causare valido chiamate tra thread.Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. Per tutte le altre chiamate di metodo, è consigliabile usare uno dei metodi invoke per effettuare il marshalling della chiamata al thread del controllo.For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. I metodi invoke richiamano sempre il callback sul thread del controllo.The invoke methods always invoke their callbacks on the control's thread.

Nota

Potrebbe essere generata un'eccezione se il thread che debba elaborare il messaggio non è più attivo.An exception might be thrown if the thread that should process the message is no longer active.

Vedi anche

Si applica a