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 'Invoke_Click

Public Sub InvokeMethod()
   myTextBox.Text = "Executed the given delegate"
End Sub 'InvokeMethod

Комментарии

Делегат вызывается асинхронно, и этот метод немедленно возвращает значение.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 свойства, существует четыре метода элемента управления, которые являются потокобезопасными: Invoke, BeginInvoke EndInvoke, и CreateGraphics , если уже был создан обработчик для элемента управления.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 'Button_Click

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 'DelegateMethod

Комментарии

Делегат вызывается асинхронно, и этот метод немедленно возвращает значение.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 свойства, существует четыре метода элемента управления, которые являются потокобезопасными: Invoke, BeginInvoke EndInvoke, и CreateGraphics , если уже был создан обработчик для элемента управления.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.

Дополнительно

Применяется к