ISynchronizeInvoke Interfejs

Definicja

Zapewnia sposób synchronicznego lub asynchronicznego wykonywania delegata.Provides a way to synchronously or asynchronously execute a delegate.

public interface class ISynchronizeInvoke
public interface ISynchronizeInvoke
type ISynchronizeInvoke = interface
Public Interface ISynchronizeInvoke
Pochodne

Uwagi

ISynchronizeInvokeInterfejs zapewnia synchroniczną i asynchroniczną komunikację między obiektami o wystąpieniu zdarzenia.The ISynchronizeInvoke interface provides synchronous and asynchronous communication between objects about the occurrence of an event. Obiekty implementujące ten interfejs mogą odbierać powiadomienia o wystąpieniu zdarzenia i mogą reagować na zapytania dotyczące zdarzenia.Objects that implement this interface can receive notification that an event has occurred, and they can respond to queries about the event. Dzięki temu klienci mogą upewnić się, że jedno żądanie zostało przetworzone przed przesłaniem kolejnego żądania, które zależy od ukończenia pierwszego.In this way, clients can ensure that one request has been processed before they submit a subsequent request that depends on completion of the first.

ISynchronizeInvokeKlasa zapewnia dwa sposoby wywoływania procesu:The ISynchronizeInvoke class provides two ways to invoke a process:

  1. Asynchronicznie, za pomocą BeginInvoke metody.Asynchronously, by using the BeginInvoke method. BeginInvoke uruchamia proces, a następnie zwraca natychmiast.BeginInvoke starts a process and then returns immediately. Użyj EndInvoke , aby poczekać, aż proces zostanie uruchomiony po BeginInvoke zakończeniu.Use EndInvoke to wait until the process started by BeginInvoke completes.

  2. Synchronicznie, za pomocą Invoke metody.Synchronously, by using the Invoke method. Invoke uruchamia proces, czeka do jego zakończenia, a następnie zwraca.Invoke starts a process, waits until it completes, and then returns. Użyj, Invoke gdy główny wątek formantu różni się od wątku wywołującego, aby skierować wywołanie do właściwego wątku.Use Invoke when the control's main thread is different from the calling thread to marshal the call to the proper thread.

Uwaga

HostProtectionAttributeAtrybut zastosowany do tej klasy ma następującą Resources wartość właściwości: Synchronization | ExternalThreading .The HostProtectionAttribute attribute applied to this class has the following Resources property value: Synchronization | ExternalThreading. Atrybut HostProtectionAttribute nie ma wpływu na aplikacje pulpitu (które typowo są uruchamiane przez dwukrotne kliknięcie ikony, wpisanie polecenia albo wprowadzenie adresu URL w przeglądarce).The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). Aby uzyskać więcej informacji, zobacz HostProtectionAttribute atrybuty programowania klasy lub SQL Server i ochrony hosta.For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

Właściwości

InvokeRequired

Pobiera wartość wskazującą, czy obiekt wywołujący musi wywołać Invoke(Delegate, Object[]) podczas wywoływania obiektu, który implementuje ten interfejs.Gets a value indicating whether the caller must call Invoke(Delegate, Object[]) when calling an object that implements this interface.

Metody

BeginInvoke(Delegate, Object[])

Asynchronicznie wykonuje delegata w wątku, który utworzył ten obiekt.Asynchronously executes the delegate on the thread that created this object.

EndInvoke(IAsyncResult)

Czeka, aż proces zostanie uruchomiony przez wywołanie metody BeginInvoke(Delegate, Object[]) Zakończ, a następnie zwróci wartość wygenerowaną przez proces.Waits until the process started by calling BeginInvoke(Delegate, Object[]) completes, and then returns the value generated by the process.

Invoke(Delegate, Object[])

Synchronicznie wykonuje delegata w wątku, który utworzył ten obiekt i kierowanie wywołania do wątku tworzenia.Synchronously executes the delegate on the thread that created this object and marshals the call to the creating thread.

Dotyczy

Zobacz też