Control.BeginInvoke Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Esegue in modo asincrono un delegato nel thread in cui è stato creato il punto di controllo sottostante del controllo.

Overload

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.
BeginInvoke(Action)

Esegue in modo asincrono il delegato specificato nel thread in cui è stato creato il punto di controllo sottostante del controllo.
BeginInvoke(Delegate)

Esegue in modo asincrono il delegato specificato nel thread in cui è stato creato il punto di controllo sottostante del controllo.

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.

public:
 virtual IAsyncResult ^ BeginInvoke(Delegate ^ method, cli::array <System::Object ^> ^ args);
public:
 virtual IAsyncResult ^ BeginInvoke(Delegate ^ method, ... cli::array <System::Object ^> ^ args);
public IAsyncResult BeginInvoke (Delegate method, 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, args As Object()) As IAsyncResult
Public Function BeginInvoke (method As Delegate, ParamArray args As Object()) As IAsyncResult

Parametri

method
Delegate

Delegato di un metodo che accetta parametri dello stesso tipo e numero contenuti nel parametro args.

args
Object[]

Matrice di oggetti da passare come argomenti al metodo specificato. Se non sono richiesti argomenti, può corrispondere a null.

Restituisce

IAsyncResult

Oggetto IAsyncResult che rappresenta il risultato dell'operazione BeginInvoke(Delegate).

Implementazioni

BeginInvoke(Delegate, Object[])

Eccezioni

InvalidOperationException

Impossibile trovare un handle di finestra appropriato.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del BeginInvoke metodo .

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

Commenti

Il delegato viene chiamato in modo asincrono e questo metodo restituisce immediatamente. È possibile chiamare questo metodo da qualsiasi thread, anche dal thread proprietario dell'handle del controllo. Se l'handle del controllo non esiste ancora, questo metodo esegue la ricerca nella catena padre del controllo fino a quando non trova un controllo o una maschera con un handle di finestra. Se non viene trovato alcun handle appropriato, BeginInvoke genererà un'eccezione. Le eccezioni all'interno del metodo delegato vengono considerate non mappate e verranno inviate al gestore eccezioni non intrappolato dell'applicazione.

È possibile chiamare EndInvoke per recuperare il valore restituito dal delegato, se neccesary, ma non è obbligatorio. EndInvoke verrà bloccato fino a quando non sarà possibile recuperare il valore restituito.

Nota

La maggior parte dei metodi in un controllo può essere chiamata solo dal thread in cui è stato creato il controllo. Oltre alla InvokeRequired proprietà, sono disponibili quattro metodi su un controllo thread-safe: Invoke, BeginInvoke, EndInvokee CreateGraphics se l'handle per il controllo è già stato creato. La chiamata CreateGraphics prima che l'handle del controllo sia stato creato in un thread in background può causare chiamate tra thread non valide. Per tutte le altre chiamate di metodo, è consigliabile usare uno dei metodi invoke per effettuare il marshalling della chiamata al thread del controllo. I metodi invoke richiamano sempre i callback nel thread del controllo.

Nota

È possibile che venga generata un'eccezione se il thread che deve elaborare il messaggio non è più attivo.

Vedi anche

Si applica a

BeginInvoke(Action)

Esegue in modo asincrono il delegato specificato nel thread in cui è stato creato il punto di controllo sottostante del controllo.

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

Parametri

method
Action

Delegato di un metodo che non accetta parametri.

Restituisce

IAsyncResult

Oggetto IAsyncResult che rappresenta il risultato dell'operazione BeginInvoke(Action).

Si applica a

BeginInvoke(Delegate)

Esegue in modo asincrono il delegato specificato nel thread in cui è stato creato il punto di controllo sottostante del controllo.

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

Delegato di un metodo che non accetta parametri.

Restituisce

IAsyncResult

Oggetto IAsyncResult che rappresenta il risultato dell'operazione BeginInvoke(Delegate).

Eccezioni

InvalidOperationException

Impossibile trovare un handle di finestra appropriato.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del BeginInvoke metodo .

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

Commenti

Il delegato viene chiamato in modo asincrono e questo metodo restituisce immediatamente. È possibile chiamare questo metodo da qualsiasi thread, anche dal thread proprietario dell'handle del controllo. Se l'handle del controllo non esiste ancora, questo metodo esegue la ricerca nella catena padre del controllo fino a quando non trova un controllo o una maschera con un handle di finestra. Se non viene trovato alcun handle appropriato, BeginInvoke genererà un'eccezione. Le eccezioni all'interno del metodo delegato vengono considerate non mappate e verranno inviate al gestore eccezioni non intrappolato dell'applicazione.

È possibile chiamare EndInvoke per recuperare il valore restituito dal delegato, se neccesary, ma non è obbligatorio. EndInvoke verrà bloccato fino a quando non sarà possibile recuperare il valore restituito.

Nota

La maggior parte dei metodi in un controllo può essere chiamata solo dal thread in cui è stato creato il controllo. Oltre alla InvokeRequired proprietà, sono disponibili quattro metodi su un controllo thread-safe: Invoke, BeginInvoke, EndInvokee CreateGraphics se l'handle per il controllo è già stato creato. La chiamata CreateGraphics prima che l'handle del controllo sia stato creato in un thread in background può causare chiamate tra thread non valide. Per tutte le altre chiamate di metodo, è consigliabile usare uno dei metodi invoke per effettuare il marshalling della chiamata al thread del controllo. I metodi invoke richiamano sempre i callback nel thread del controllo.

Nota

È possibile che venga generata un'eccezione se il thread che deve elaborare il messaggio non è più attivo.

Vedi anche

Si applica a