Control.BeginInvoke Methode

public:
 IAsyncResult ^ BeginInvoke(Delegate ^ method);

public IAsyncResult BeginInvoke(Delegate method);

member this.BeginInvoke : Delegate -> IAsyncResult

Public Function BeginInvoke (method As Delegate) As IAsyncResult

Parameters

Retouren

Een IAsyncResult die het resultaat van de BeginInvoke(Delegate) bewerking aangeeft.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u een gebruik van de BeginInvoke methode.

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

Opmerkingen

De gemachtigde wordt asynchroon aangeroepen en deze methode retourneert onmiddellijk. U kunt deze methode aanroepen vanuit elke thread, zelfs de thread die eigenaar is van de ingang van het besturingselement. Als de ingang van het besturingselement nog niet bestaat, wordt met deze methode gezocht naar de bovenliggende keten van het besturingselement totdat er een besturingselement of formulier wordt gevonden dat wel een venstergreep heeft. Als er geen geschikte ingang kan worden gevonden, BeginInvoke genereert u een uitzondering. Uitzonderingen binnen de gedelegeerde methode worden beschouwd als niet-afgenomen en worden verzonden naar de niet-afgemaakte uitzonderingshandler van de toepassing.

U kunt aanroepen EndInvoke om de retourwaarde van de gemachtigde op te halen, indien nodig, maar dit is niet vereist. EndInvoke wordt geblokkeerd totdat de retourwaarde kan worden opgehaald.

Zie ook

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

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

Parameters

Retouren

Een IAsyncResult die het resultaat van de BeginInvoke(Delegate) bewerking aangeeft.

Implementeringen

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u een gebruik van de BeginInvoke methode.

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

Opmerkingen

De gemachtigde wordt asynchroon aangeroepen en deze methode retourneert onmiddellijk. U kunt deze methode aanroepen vanuit elke thread, zelfs de thread die eigenaar is van de ingang van het besturingselement. Als de ingang van het besturingselement nog niet bestaat, wordt met deze methode gezocht naar de bovenliggende keten van het besturingselement totdat er een besturingselement of formulier wordt gevonden dat wel een venstergreep heeft. Als er geen geschikte ingang kan worden gevonden, BeginInvoke genereert u een uitzondering. Uitzonderingen binnen de gedelegeerde methode worden beschouwd als niet-afgenomen en worden verzonden naar de niet-afgemaakte uitzonderingshandler van de toepassing.

U kunt aanroepen EndInvoke om de retourwaarde van de gemachtigde op te halen, indien nodig, maar dit is niet vereist. EndInvoke wordt geblokkeerd totdat de retourwaarde kan worden opgehaald.

Zie ook

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