Control.Invoke Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Esegue un delegato sul thread proprietario dell'handle della finestra sottostante del controllo.

Overload

Invoke(Action)	Esegue il delegato specificato nel thread proprietario dell'handle della finestra sottostante del controllo.
Invoke(Delegate)	Esegue il delegato specificato nel thread proprietario dell'handle della finestra sottostante del controllo.
Invoke(Delegate, Object[])	Esegue il delegato specificato, nel thread proprietario dell'handle della finestra sottostante del controllo, con l'elenco specificato di argomenti.
Invoke<T>(Func<T>)	Esegue il delegato specificato nel thread proprietario dell'handle della finestra sottostante del controllo.

Invoke(Action)

Esegue il delegato specificato nel thread proprietario dell'handle della finestra sottostante del controllo.

C#

public void Invoke (Action method);

Parametri

method

Action

Delegato che contiene un metodo da chiamare nel contesto del thread del controllo.

Invoke(Delegate)

Esegue il delegato specificato nel thread proprietario dell'handle della finestra sottostante del controllo.

C#

public object Invoke (Delegate method);

Parametri

method

Delegate

Delegato che contiene un metodo da chiamare nel contesto del thread del controllo.

Restituisce

Object

Valore restituito dal delegato richiamato o null se il delegato non ha alcun valore restituito.

Esempio

Nell'esempio di codice seguente vengono illustrati i controlli che contengono un delegato. Il delegato incapsula un metodo che aggiunge elementi alla casella di riepilogo e questo metodo viene eseguito nel thread proprietario dell'handle sottostante del modulo. Quando l'utente fa clic sul pulsante, Invoke esegue il delegato.

C#

/*
The following example demonstrates the 'Invoke(Delegate)' method of 'Control class.
A 'ListBox' and a 'Button' control are added to a form, containing a delegate
which encapsulates a method that adds items to the listbox. This function is executed
on the thread that owns the underlying handle of the form. When user clicks on button
the above delegate is executed using 'Invoke' method.


*/

using System;
using System.Drawing;
using System.Windows.Forms;
using System.Threading;

   public class MyFormControl : Form
   {
      public delegate void AddListItem();
      public AddListItem myDelegate;
      private Button myButton;
      private Thread myThread;
      private ListBox myListBox;
      public MyFormControl()
      {
         myButton = new Button();
         myListBox = new ListBox();
         myButton.Location = new Point(72, 160);
         myButton.Size = new Size(152, 32);
         myButton.TabIndex = 1;
         myButton.Text = "Add items in list box";
         myButton.Click += new EventHandler(Button_Click);
         myListBox.Location = new Point(48, 32);
         myListBox.Name = "myListBox";
         myListBox.Size = new Size(200, 95);
         myListBox.TabIndex = 2;
         ClientSize = new Size(292, 273);
         Controls.AddRange(new Control[] {myListBox,myButton});
         Text = " 'Control_Invoke' example";
         myDelegate = new AddListItem(AddListItemMethod);
      }
      static void Main()
      {
         MyFormControl myForm = new MyFormControl();
         myForm.ShowDialog();
      }
      public void AddListItemMethod()
      {
         String myItem;
         for(int i=1;i<6;i++)
         {
            myItem = "MyListItem" + i.ToString();
            myListBox.Items.Add(myItem);
            myListBox.Update();
            Thread.Sleep(300);
         }
      }
      private void Button_Click(object sender, EventArgs e)
      {
         myThread = new Thread(new ThreadStart(ThreadFunction));
         myThread.Start();
      }
      private void ThreadFunction()
      {
         MyThreadClass myThreadClassObject  = new MyThreadClass(this);
         myThreadClassObject.Run();
      }
   }

// The following code assumes a 'ListBox' and a 'Button' control are added to a form, 
// containing a delegate which encapsulates a method that adds items to the listbox.

   public class MyThreadClass
   {
      MyFormControl myFormControl1;
      public MyThreadClass(MyFormControl myForm)
      {
         myFormControl1 = myForm;
      }

      public void Run()
      {
         // Execute the specified delegate on the thread that owns
         // 'myFormControl1' control's underlying window handle.
         myFormControl1.Invoke(myFormControl1.myDelegate);
      }
   }

Commenti

I delegati sono simili ai puntatori a funzione nei linguaggi C o C++. I delegati incapsulano un riferimento a un metodo all'interno di un oggetto delegato. L'oggetto delegato può quindi essere passato al codice che chiama il metodo a cui si fa riferimento e il metodo da richiamare può essere sconosciuto in fase di compilazione. A differenza dei puntatori a funzione in C o C++, i delegati sono orientati agli oggetti, indipendenti dai tipi e più sicuri.

Il metodo Invoke cerca la catena padre del controllo fino a quando non trova un controllo o una maschera con un handle di finestra se l'handle della finestra sottostante del controllo corrente non esiste ancora. Se non è possibile trovare un handle appropriato, il metodo Invoke genererà un'eccezione. Le eccezioni generate durante la chiamata verranno propagate nuovamente al chiamante.

Nota

Oltre alla proprietà InvokeRequired, 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.

Il delegato può essere un'istanza di EventHandler, nel qual caso il parametro sender conterrà questo controllo e il parametro evento conterrà EventArgs.Empty. Il delegato può anche essere un'istanza di MethodInvokero qualsiasi altro delegato che accetta un elenco di parametri void. Una chiamata a un delegato EventHandler o MethodInvoker sarà più veloce di una chiamata a un altro tipo di delegato.

Nota

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

Vedi anche

• MethodInvoker
• InvokeRequired

Invoke(Delegate, Object[])

Esegue il delegato specificato, nel thread proprietario dell'handle della finestra sottostante del controllo, con l'elenco specificato di argomenti.

C#

public object Invoke (Delegate method, params object?[]? args);

Parametri

method

Delegate

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

args

Object[]

Matrice di oggetti da passare come argomenti al metodo specificato. Questo parametro può essere null se il metodo non accetta argomenti.

Restituisce

Object

Un Object che contiene il valore restituito dal delegato richiamato oppure null se il delegato non ha alcun valore restituito.

Implementazioni

Invoke(Delegate, Object[])

Esempio

Nell'esempio di codice seguente vengono illustrati i controlli che contengono un delegato. Il delegato incapsula un metodo che aggiunge elementi alla casella di riepilogo e questo metodo viene eseguito nel thread proprietario dell'handle sottostante del modulo, utilizzando gli argomenti specificati. Quando l'utente fa clic sul pulsante, Invoke esegue il delegato.

C#

using System;
using System.Drawing;
using System.Windows.Forms;
using System.Threading;

   public class MyFormControl : Form
   {
      public delegate void AddListItem(String myString);
      public AddListItem myDelegate;
      private Button myButton;
      private Thread myThread;
      private ListBox myListBox;
      public MyFormControl()
      {
         myButton = new Button();
         myListBox = new ListBox();
         myButton.Location = new Point(72, 160);
         myButton.Size = new Size(152, 32);
         myButton.TabIndex = 1;
         myButton.Text = "Add items in list box";
         myButton.Click += new EventHandler(Button_Click);
         myListBox.Location = new Point(48, 32);
         myListBox.Name = "myListBox";
         myListBox.Size = new Size(200, 95);
         myListBox.TabIndex = 2;
         ClientSize = new Size(292, 273);
         Controls.AddRange(new Control[] {myListBox,myButton});
         Text = " 'Control_Invoke' example ";
         myDelegate = new AddListItem(AddListItemMethod);
      }
      static void Main()
      {
         MyFormControl myForm = new MyFormControl();
         myForm.ShowDialog();
      }
      public void AddListItemMethod(String myString)
      {
            myListBox.Items.Add(myString);
      }
      private void Button_Click(object sender, EventArgs e)
      {
         myThread = new Thread(new ThreadStart(ThreadFunction));
         myThread.Start();
      }
      private void ThreadFunction()
      {
         MyThreadClass myThreadClassObject  = new MyThreadClass(this);
         myThreadClassObject.Run();
      }
   }
   public class MyThreadClass
   {
      MyFormControl myFormControl1;
      public MyThreadClass(MyFormControl myForm)
      {
         myFormControl1 = myForm;
      }
      String myString;

      public void Run()
      {

         for (int i = 1; i <= 5; i++)
         {
            myString = "Step number " + i.ToString() + " executed";
            Thread.Sleep(400);
            // Execute the specified delegate on the thread that owns
            // 'myFormControl1' control's underlying window handle with
            // the specified list of arguments.
            myFormControl1.Invoke(myFormControl1.myDelegate,
                                   new Object[] {myString});
         }
      }
   }

Commenti

I delegati sono simili ai puntatori a funzione nei linguaggi C o C++. I delegati incapsulano un riferimento a un metodo all'interno di un oggetto delegato. L'oggetto delegato può quindi essere passato al codice che chiama il metodo a cui si fa riferimento e il metodo da richiamare può essere sconosciuto in fase di compilazione. A differenza dei puntatori a funzione in C o C++, i delegati sono orientati agli oggetti, indipendenti dai tipi e più sicuri.

Se l'handle del controllo non esiste ancora, questo metodo cerca la catena padre del controllo fino a quando non trova un controllo o un modulo che dispone di un handle di finestra. Se non è possibile trovare un handle appropriato, questo metodo genera un'eccezione. Le eccezioni generate durante la chiamata verranno propagate nuovamente al chiamante.

Nota

Oltre alla proprietà InvokeRequired, 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.

Il delegato può essere un'istanza di EventHandler, nel qual caso i parametri dipenderanno dal valore args:

• Se non vengono passati parametri, il parametro sender conterrà questo controllo e il parametro dell'evento conterrà EventArgs.Empty.
• Quando viene passato un singolo parametro, il parametro sender conterrà il primo elemento args e il parametro event conterrà EventArgs.Empty.
• Se vengono passati più parametri, il parametro sender conterrà il primo elemento di argse il parametro EventArgs conterrà il secondo elemento.

Una chiamata a un delegato EventHandler o MethodInvoker sarà più veloce di una chiamata a un altro tipo di delegato.

Nota

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

Vedi anche

• MethodInvoker
• InvokeRequired

Invoke<T>(Func<T>)

Esegue il delegato specificato nel thread proprietario dell'handle della finestra sottostante del controllo.

C#

public T Invoke<T> (Func<T> method);

Parametri di tipo

T

Tipo restituito del method.

Parametri

method

Func<T>

Funzione da chiamare nel contesto del thread del controllo.

Restituisce

T

Valore restituito dalla funzione richiamata.