Control.Invoke Metoda

public void Invoke (Action method);

Parametry

public object Invoke (Delegate method);

Parametry

Návraty

Vrácená hodnota z vyvolané delegáta nebo null, pokud delegát nemá žádnou vrácenou hodnotu.

Příklady

Následující příklad kódu ukazuje ovládací prvky, které obsahují delegáta. Delegát zapouzdřuje metodu, která přidává položky do seznamu, a tato metoda se provádí ve vlákně, které vlastní podkladový popisovač formuláře. Když uživatel klikne na tlačítko, Invoke spustí delegáta.

/*
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);
      }
   }

Poznámky

Delegáti se podobají ukazatelům funkcí v jazycích C nebo C++. Delegáti zapouzdřují odkaz na metodu uvnitř objektu delegáta. Delegovaný objekt lze pak předat kódu, který volá odkazovanou metodu, a metoda, která se má vyvolat, může být v době kompilace neznámá. Na rozdíl od ukazatelů funkcí v jazyce C nebo C++ jsou delegáti objektově orientované, typově bezpečné a bezpečnější.

Metoda Invoke hledá nadřazený řetězec ovládacího prvku, dokud nenajde ovládací prvek nebo formulář, který má popisovač okna, pokud podkladový popisovač okna aktuálního ovládacího prvku ještě neexistuje. Pokud nenajdete žádný vhodný popisovač, metoda Invoke vyvolá výjimku. Výjimky, které jsou vyvolány během volání, se rozšíří zpět do volajícího.

Delegát může být instancí EventHandler, v takovém případě bude parametr odesílatele obsahovat tento ovládací prvek a parametr události bude obsahovat EventArgs.Empty. Delegátem může být také instance MethodInvokernebo jakýkoli jiný delegát, který přebírá seznam parametrů void. Volání delegáta EventHandler nebo MethodInvoker bude rychlejší než volání jiného typu delegáta.

Viz také

• MethodInvoker
• InvokeRequired

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

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

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

Parametry

Návraty

Object, která obsahuje návratovou hodnotu z vyvolané delegáta, nebo null, pokud delegát nemá žádnou návratovou hodnotu.

Implementuje

Příklady

Následující příklad kódu ukazuje ovládací prvky, které obsahují delegáta. Delegát zapouzdřuje metodu, která přidává položky do seznamu, a tato metoda se provádí ve vlákně, které vlastní podkladový popisovač formuláře pomocí zadaných argumentů. Když uživatel klikne na tlačítko, Invoke spustí delegáta.

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});
         }
      }
   }

Poznámky

Delegáti se podobají ukazatelům funkcí v jazycích C nebo C++. Delegáti zapouzdřují odkaz na metodu uvnitř objektu delegáta. Delegovaný objekt lze pak předat kódu, který volá odkazovanou metodu, a metoda, která se má vyvolat, může být v době kompilace neznámá. Na rozdíl od ukazatelů funkcí v jazyce C nebo C++ jsou delegáti objektově orientované, typově bezpečné a bezpečnější.

Pokud popisovač ovládacího prvku ještě neexistuje, tato metoda vyhledá nadřazený řetězec ovládacího prvku, dokud nenajde ovládací prvek nebo formulář, který má popisovač okna. Pokud nelze najít žádný vhodný popisovač, tato metoda vyvolá výjimku. Výjimky, které jsou vyvolány během volání, se rozšíří zpět do volajícího.

Delegát může být instancí EventHandler, v takovém případě budou parametry záviset na args hodnotě:

• Pokud nejsou předány žádné parametry, parametr odesílatele bude obsahovat tento ovládací prvek a parametr události bude obsahovat EventArgs.Empty.
• Při předání jednoho parametru bude parametr sender obsahovat první prvek args a parametr události bude obsahovat EventArgs.Empty.
• Pokud je předán více než jeden parametr, bude parametr sender obsahovat první prvek z argsa EventArgs parametr bude obsahovat druhý prvek.

Volání delegáta EventHandler nebo MethodInvoker bude rychlejší než volání jiného typu delegáta.

Viz také

• MethodInvoker
• InvokeRequired

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

Parametry typu

Parametry

Návraty

Vrácená hodnota z funkce, která se vyvolá.