Control.BeginInvoke Control.BeginInvoke Control.BeginInvoke Control.BeginInvoke Method

定義

コントロールの基になるハンドルが作成されたスレッド上で、非同期的にデリゲートを実行します。Executes a delegate asynchronously on the thread that the control's underlying handle was created on.

オーバーロード

BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate)

コントロールの基になるハンドルが作成されたスレッド上で、指定したデリゲートを非同期的に実行します。Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[])

コントロールの基になるハンドルが作成されたスレッド上で、指定した引数で指定したデリゲートを非同期的に実行します。Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate) BeginInvoke(Delegate)

コントロールの基になるハンドルが作成されたスレッド上で、指定したデリゲートを非同期的に実行します。Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

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

パラメーター

method
Delegate Delegate Delegate Delegate

パラメーターをとらないメソッドへのデリゲート。A delegate to a method that takes no parameters.

戻り値

IAsyncResult 操作の結果を表す BeginInvoke(Delegate)An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

例外

適切なウィンドウ ハンドルが見つかりません。No appropriate window handle can be found.

次のコード例は、 BeginInvokeメソッドの使用方法を示しています。The following code example demonstrates a use of the BeginInvoke method.

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

注釈

デリゲートは非同期的に呼び出され、このメソッドは直ちに制御を返します。The delegate is called asynchronously, and this method returns immediately. このメソッドは、コントロールのハンドルを所有するスレッドでも、任意のスレッドから呼び出すことができます。You can call this method from any thread, even the thread that owns the control's handle. コントロールのハンドルがまだ存在しない場合、このメソッドは、ウィンドウハンドルを持つコントロールまたはフォームが見つかるまで、コントロールの親チェインを検索します。If the control's handle does not exist yet, this method searches up the control's parent chain until it finds a control or form that does have a window handle. 適切なハンドルが見つからない場合、 BeginInvokeは例外をスローします。If no appropriate handle can be found, BeginInvoke will throw an exception. デリゲートメソッド内の例外は、トラップされていないと見なされ、アプリケーションのトラップされていない例外ハンドラーに送信されます。Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

を呼び出しEndInvokeて、必要の場合、デリゲートから戻り値を取得できますが、これは必須ではありません。You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvokeは、戻り値を取得できるようになるまでブロックします。EndInvoke will block until the return value can be retrieved.

注意

コントロールのほとんどのメソッドは、コントロールが作成されたスレッドからのみ呼び出すことができます。Most methods on a control can only be called from the thread where the control was created. InvokeRequiredプロパティに加えて、スレッドセーフであるコントロールには、、 EndInvoke Invoke BeginInvoke、、およびCreateGraphicsコントロールのハンドルが既に作成されている場合の4つのメソッドがあります。In addition to the InvokeRequired property, there are four methods on a control that are thread safe: Invoke, BeginInvoke, EndInvoke, and CreateGraphics if the handle for the control has already been created. バックグラウンドCreateGraphicsスレッドでコントロールのハンドルが作成される前にを呼び出すと、無効なクロススレッド呼び出しが発生する可能性があります。Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. その他のすべてのメソッド呼び出しでは、いずれかの invoke メソッドを使用して、コントロールのスレッドへの呼び出しをマーシャリングする必要があります。For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. Invoke メソッドは、常にコントロールのスレッドでコールバックを呼び出します。The invoke methods always invoke their callbacks on the control's thread.

注意

メッセージを処理する必要があるスレッドがアクティブでなくなった場合は、例外がスローされる可能性があります。An exception might be thrown if the thread that should process the message is no longer active.

セキュリティ

SecurityPermission
直前の呼び出し元がアンマネージコードを呼び出す場合は。for the immediate caller to call unmanaged code. 関連付けられた列挙型:UnmanagedCodeAssociated enumeration: UnmanagedCode

こちらもご覧ください

BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[]) BeginInvoke(Delegate, Object[])

コントロールの基になるハンドルが作成されたスレッド上で、指定した引数で指定したデリゲートを非同期的に実行します。Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

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

パラメーター

method
Delegate Delegate Delegate Delegate

args パラメーターに指定されている数および型と同じ数および型のパラメーターをとるメソッドへのデリゲート。A delegate to a method that takes parameters of the same number and type that are contained in the args parameter.

args
Object[]

特定のメソッドに引数として渡すオブジェクトの配列。An array of objects to pass as arguments to the given method. 引数が必要ない場合は、null を指定できます。This can be null if no arguments are needed.

戻り値

IAsyncResult 操作の結果を表す BeginInvoke(Delegate)An IAsyncResult that represents the result of the BeginInvoke(Delegate) operation.

実装

例外

適切なウィンドウ ハンドルが見つかりません。No appropriate window handle can be found.

次のコード例は、 BeginInvokeメソッドの使用方法を示しています。The following code example demonstrates a use of the BeginInvoke method.

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

注釈

デリゲートは非同期的に呼び出され、このメソッドは直ちに制御を返します。The delegate is called asynchronously, and this method returns immediately. このメソッドは、コントロールのハンドルを所有するスレッドでも、任意のスレッドから呼び出すことができます。You can call this method from any thread, even the thread that owns the control's handle. コントロールのハンドルがまだ存在しない場合、このメソッドは、ウィンドウハンドルを持つコントロールまたはフォームが見つかるまで、コントロールの親チェインを検索します。If the control's handle does not exist yet, this method searches up the control's parent chain until it finds a control or form that does have a window handle. 適切なハンドルが見つからない場合、 BeginInvokeは例外をスローします。If no appropriate handle can be found, BeginInvoke will throw an exception. デリゲートメソッド内の例外は、トラップされていないと見なされ、アプリケーションのトラップされていない例外ハンドラーに送信されます。Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.

を呼び出しEndInvokeて、必要の場合、デリゲートから戻り値を取得できますが、これは必須ではありません。You can call EndInvoke to retrieve the return value from the delegate, if neccesary, but this is not required. EndInvokeは、戻り値を取得できるようになるまでブロックします。EndInvoke will block until the return value can be retrieved.

注意

コントロールのほとんどのメソッドは、コントロールが作成されたスレッドからのみ呼び出すことができます。Most methods on a control can only be called from the thread where the control was created. InvokeRequiredプロパティに加えて、スレッドセーフであるコントロールには、、 EndInvoke Invoke BeginInvoke、、およびCreateGraphicsコントロールのハンドルが既に作成されている場合の4つのメソッドがあります。In addition to the InvokeRequired property, there are four methods on a control that are thread safe: Invoke, BeginInvoke, EndInvoke, and CreateGraphics if the handle for the control has already been created. バックグラウンドCreateGraphicsスレッドでコントロールのハンドルが作成される前にを呼び出すと、無効なクロススレッド呼び出しが発生する可能性があります。Calling CreateGraphics before the control's handle has been created on a background thread can cause illegal cross thread calls. その他のすべてのメソッド呼び出しでは、いずれかの invoke メソッドを使用して、コントロールのスレッドへの呼び出しをマーシャリングする必要があります。For all other method calls, you should use one of the invoke methods to marshal the call to the control's thread. Invoke メソッドは、常にコントロールのスレッドでコールバックを呼び出します。The invoke methods always invoke their callbacks on the control's thread.

注意

メッセージを処理する必要があるスレッドがアクティブでなくなった場合は、例外がスローされる可能性があります。An exception might be thrown if the thread that should process the message is no longer active.

こちらもご覧ください

適用対象