Control.BeginInvoke Metoda

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

Parametry

Návraty

IAsyncResult

Výsledek IAsyncResult BeginInvoke(Delegate) operace představuje.

Implementuje

Výjimky

Příklady

Následující příklad kódu ukazuje použití BeginInvoke metody.

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

Poznámky

Delegát se nazývá asynchronně a tato metoda vrátí okamžitě. Tuto metodu můžete volat z libovolného vlákna, dokonce i vlákna, které vlastní popisovač ovládacího prvku. 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á úchyt okna. Pokud nenajdete žádný vhodný popisovač, BeginInvoke vyvolá se výjimka. Výjimky v rámci metody delegáta se považují za neschycené a budou odeslány do obslužné rutiny výjimky untrapped aplikace.

Můžete zavolat EndInvoke , aby se z delegáta načetla vrácená hodnota, pokud není k dispozici, ale není to nutné. EndInvoke zablokuje, dokud nebude možné načíst vrácenou hodnotu.

Viz také

• IAsyncResult
• EndInvoke(IAsyncResult)
• Invoke(Delegate)
• CreateGraphics()
• InvokeRequired

public:
 IAsyncResult ^ BeginInvoke(Action ^ method);

public IAsyncResult BeginInvoke (Action method);

member this.BeginInvoke : Action -> IAsyncResult

Public Function BeginInvoke (method As Action) As IAsyncResult

Parametry

Návraty

IAsyncResult

Výsledek IAsyncResult BeginInvoke(Action) operace představuje.

public:
 IAsyncResult ^ BeginInvoke(Delegate ^ method);

public IAsyncResult BeginInvoke (Delegate method);

member this.BeginInvoke : Delegate -> IAsyncResult

Public Function BeginInvoke (method As Delegate) As IAsyncResult

Parametry

Návraty

IAsyncResult

Výsledek IAsyncResult BeginInvoke(Delegate) operace představuje.

Výjimky

Příklady

Následující příklad kódu ukazuje použití BeginInvoke metody.

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

Poznámky

Delegát se nazývá asynchronně a tato metoda vrátí okamžitě. Tuto metodu můžete volat z libovolného vlákna, dokonce i vlákna, které vlastní popisovač ovládacího prvku. 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á úchyt okna. Pokud nenajdete žádný vhodný popisovač, BeginInvoke vyvolá se výjimka. Výjimky v rámci metody delegáta se považují za neschycené a budou odeslány do obslužné rutiny výjimky untrapped aplikace.

Můžete zavolat EndInvoke , aby se z delegáta načetla vrácená hodnota, pokud není k dispozici, ale není to nutné. EndInvoke zablokuje, dokud nebude možné načíst vrácenou hodnotu.

Viz také

• IAsyncResult
• EndInvoke(IAsyncResult)
• Invoke(Delegate)
• CreateGraphics()
• InvokeRequired