Dispatcher.Invoke Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Threading

Zestaw:: WindowsBase.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wykonuje określony delegat synchronicznie w wątku, z który Dispatcher jest skojarzony.

Przeciążenia

Invoke(DispatcherPriority, TimeSpan, Delegate, Object, Object[])	Wykonuje określonego delegata o określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher skojarzonym z.
Invoke(DispatcherPriority, TimeSpan, Delegate, Object)	Wykonuje określonego delegata o określonym priorytetzie z określonym argumentem synchronicznie w wątku Dispatcher skojarzonym z.
Invoke(DispatcherPriority, Delegate, Object, Object[])	Wykonuje określonego delegata o określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher skojarzonym z.
Invoke(Action, DispatcherPriority, CancellationToken, TimeSpan)	Wykonuje określony Action synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.
Invoke(DispatcherPriority, TimeSpan, Delegate)	Wykonuje określony delegat synchronicznie o określonym priorytetzie i z określoną wartością limitu czasu w wątku, który Dispatcher został utworzony.
Invoke(DispatcherPriority, Delegate, Object)	Wykonuje określonego delegata o określonym priorytetzie z określonym argumentem synchronicznie w wątku Dispatcher skojarzonym z.
Invoke(Delegate, TimeSpan, DispatcherPriority, Object[])	Wykonuje określonego delegata w określonym przedziale czasu na określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher , z z który jest skojarzony.
Invoke(Delegate, TimeSpan, Object[])	Wykonuje określonego delegata w określonym przedziale czasu na określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher , z z który jest skojarzony.
Invoke(Action, DispatcherPriority, CancellationToken)	Wykonuje określony Action synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.
Invoke(DispatcherPriority, Delegate)	Wykonuje określonego delegata synchronicznie na określonym priorytetzie w wątku skojarzonym Dispatcher z.
Invoke(Delegate, Object[])	Wykonuje określonego delegata z określonymi argumentami synchronicznie w wątku Dispatcher skojarzonym z.
Invoke(Action, DispatcherPriority)	Wykonuje określony Action synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.
Invoke(Action)	Wykonuje określony Action synchronicznie w wątku Dispatcher skojarzony z nim.
Invoke(Delegate, DispatcherPriority, Object[])	Wykonuje określonego delegata o określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher skojarzonym z.
Invoke<TResult>(Func<TResult>)	Wykonuje określony Func<TResult> synchronicznie w wątku Dispatcher skojarzony z nim.
Invoke<TResult>(Func<TResult>, DispatcherPriority)	Wykonuje określony Func<TResult> synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.
Invoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)	Wykonuje określony Func<TResult> synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.
Invoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken, TimeSpan)	Wykonuje określony Func<TResult> synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.

Przykłady

Poniższy przykład umieszcza delegata Dispatcher Normal na obiekcie przy użyciu polecenia Invoke.

// Places the delegate onto the UI Thread's Dispatcher
private void timer_Elapsed(object sender, ElapsedEventArgs e)
{
    // Place delegate on the Dispatcher.
    this.Dispatcher.Invoke(DispatcherPriority.Normal,
        new TimerDispatcherDelegate(TimerWorkItem));
}

' Places the delegate onto the UI Thread's Dispatcher
Private Sub timer_Elapsed(ByVal sender As Object, ByVal e As ElapsedEventArgs)
    ' Place delegate on the Dispatcher.
    Me.Dispatcher.Invoke(DispatcherPriority.Normal, New TimerDispatcherDelegate(AddressOf TimerWorkItem))
End Sub

Uwagi

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do skojarzonego Dispatcher z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń obiektu Dispatcher w określonym DispatcherPriorityobiekcie .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Invoke(DispatcherPriority, TimeSpan, Delegate, Object, Object[])

Wykonuje określonego delegata o określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher skojarzonym z.

public:
 System::Object ^ Invoke(System::Windows::Threading::DispatcherPriority priority, TimeSpan timeout, Delegate ^ method, System::Object ^ arg, ... cli::array <System::Object ^> ^ args);

[System.ComponentModel.Browsable(false)]
public object Invoke (System.Windows.Threading.DispatcherPriority priority, TimeSpan timeout, Delegate method, object arg, params object[] args);

[<System.ComponentModel.Browsable(false)>]
member this.Invoke : System.Windows.Threading.DispatcherPriority * TimeSpan * Delegate * obj * obj[] -> obj

Public Function Invoke (priority As DispatcherPriority, timeout As TimeSpan, method As Delegate, arg As Object, ParamArray args As Object()) As Object

Parametry

priority: DispatcherPriority

Priorytet, względem innych oczekujących operacji w Dispatcher kolejce zdarzeń, z którymi wywoływana jest określona metoda.

timeout: TimeSpan

Maksymalny czas oczekiwania na uruchomienie operacji. Po rozpoczęciu operacji zostanie ukończona przed zwróceniem tej metody. Aby określić nieskończone oczekiwanie, użyj wartości -1. W wywołaniu tego samego wątku każda inna wartość ujemna jest konwertowana na -1, co powoduje nieskończone oczekiwanie. W wywołaniu międzywątkowa każda inna wartość ujemna zgłasza wartość ArgumentOutOfRangeException.

method: Delegate

Delegat do metody, która przyjmuje wiele argumentów, które są wypychane do kolejki zdarzeń Dispatcher .

arg: Object

Obiekt, który ma być przekazywany jako argument do określonej metody.

args: Object[]

Tablica obiektów, które mają być przekazywane jako argumenty do określonej metody.

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym DispatcherPriorityelementem .

ArgumentNullException

method to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1, a ta metoda została wywołana w wątkach.

Uwagi

arg może być null , jeśli argument nie jest potrzebny.

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(DispatcherPriority, TimeSpan, Delegate, Object)

Wykonuje określonego delegata o określonym priorytetzie z określonym argumentem synchronicznie w wątku Dispatcher skojarzonym z.

public:
 System::Object ^ Invoke(System::Windows::Threading::DispatcherPriority priority, TimeSpan timeout, Delegate ^ method, System::Object ^ arg);

[System.ComponentModel.Browsable(false)]
public object Invoke (System.Windows.Threading.DispatcherPriority priority, TimeSpan timeout, Delegate method, object arg);

[<System.ComponentModel.Browsable(false)>]
member this.Invoke : System.Windows.Threading.DispatcherPriority * TimeSpan * Delegate * obj -> obj

Public Function Invoke (priority As DispatcherPriority, timeout As TimeSpan, method As Delegate, arg As Object) As Object

Parametry

priority: DispatcherPriority

Priorytet, względem innych oczekujących operacji w Dispatcher kolejce zdarzeń, z którymi wywoływana jest określona metoda.

timeout: TimeSpan

method: Delegate

Delegat do metody, która przyjmuje wiele argumentów, które są wypychane do kolejki zdarzeń Dispatcher .

arg: Object

Obiekt, który ma być przekazywany jako argument do danej metody. Może to być null , jeśli nie są potrzebne żadne argumenty.

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

ArgumentNullException

method to null.

Uwagi

arg może być null , jeśli argument nie jest potrzebny

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(DispatcherPriority, Delegate, Object, Object[])

Wykonuje określonego delegata o określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher skojarzonym z.

public:
 System::Object ^ Invoke(System::Windows::Threading::DispatcherPriority priority, Delegate ^ method, System::Object ^ arg, ... cli::array <System::Object ^> ^ args);

[System.ComponentModel.Browsable(false)]
public object Invoke (System.Windows.Threading.DispatcherPriority priority, Delegate method, object arg, params object[] args);

[<System.ComponentModel.Browsable(false)>]
member this.Invoke : System.Windows.Threading.DispatcherPriority * Delegate * obj * obj[] -> obj

Public Function Invoke (priority As DispatcherPriority, method As Delegate, arg As Object, ParamArray args As Object()) As Object

Parametry

priority: DispatcherPriority

Priorytet, względem innych oczekujących operacji w Dispatcher kolejce zdarzeń, z którymi wywoływana jest określona metoda.

method: Delegate

Delegat do metody, która przyjmuje wiele argumentów, które są wypychane do kolejki zdarzeń Dispatcher .

arg: Object

Obiekt, który ma być przekazywany jako argument do danej metody.

args: Object[]

Tablica obiektów, które mają być przekazywane jako argumenty do danej metody.

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

ArgumentNullException

method to null.

Uwagi

arg może być null , jeśli argument nie jest potrzebny

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(Action, DispatcherPriority, CancellationToken, TimeSpan)

Wykonuje określony Action synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.

public:
 void Invoke(Action ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken, TimeSpan timeout);

public void Invoke (Action callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken, TimeSpan timeout);

member this.Invoke : Action * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken * TimeSpan -> unit

Public Sub Invoke (callback As Action, priority As DispatcherPriority, cancellationToken As CancellationToken, timeout As TimeSpan)

Parametry

callback: Action

Delegat akcji do wywołania za pośrednictwem dyspozytora.

priority: DispatcherPriority

Priorytet określający kolejność wywoływania określonego wywołania zwrotnego względem innych oczekujących operacji w obiekcie Dispatcher.

cancellationToken: CancellationToken

Obiekt wskazujący, czy anulować akcję.

timeout: TimeSpan

Wyjątki

ArgumentNullException

callback to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1, a ta metoda została wywołana w wątkach.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Dotyczy

Invoke(DispatcherPriority, TimeSpan, Delegate)

Wykonuje określony delegat synchronicznie o określonym priorytetzie i z określoną wartością limitu czasu w wątku, który Dispatcher został utworzony.

public:
 System::Object ^ Invoke(System::Windows::Threading::DispatcherPriority priority, TimeSpan timeout, Delegate ^ method);

[System.ComponentModel.Browsable(false)]
public object Invoke (System.Windows.Threading.DispatcherPriority priority, TimeSpan timeout, Delegate method);

[<System.ComponentModel.Browsable(false)>]
member this.Invoke : System.Windows.Threading.DispatcherPriority * TimeSpan * Delegate -> obj

Public Function Invoke (priority As DispatcherPriority, timeout As TimeSpan, method As Delegate) As Object

Parametry

priority: DispatcherPriority

Priorytet, względem innych oczekujących operacji w Dispatcher kolejce zdarzeń, z którymi wywoływana jest określona metoda.

timeout: TimeSpan

method: Delegate

Delegat do metody, która nie przyjmuje żadnych argumentów, które są wypychane do kolejki zdarzeń Dispatcher .

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentNullException

method to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1, a ta metoda została wywołana w wątkach.

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

Uwagi

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(DispatcherPriority, Delegate, Object)

Wykonuje określonego delegata o określonym priorytetzie z określonym argumentem synchronicznie w wątku Dispatcher skojarzonym z.

public:
 System::Object ^ Invoke(System::Windows::Threading::DispatcherPriority priority, Delegate ^ method, System::Object ^ arg);

[System.ComponentModel.Browsable(false)]
public object Invoke (System.Windows.Threading.DispatcherPriority priority, Delegate method, object arg);

[<System.ComponentModel.Browsable(false)>]
member this.Invoke : System.Windows.Threading.DispatcherPriority * Delegate * obj -> obj

Public Function Invoke (priority As DispatcherPriority, method As Delegate, arg As Object) As Object

Parametry

priority: DispatcherPriority

Priorytet, względem innych oczekujących operacji w Dispatcher kolejce zdarzeń, z którymi wywoływana jest określona metoda.

method: Delegate

Delegat do metody, która przyjmuje jeden argument, który jest wypychany do kolejki zdarzeń Dispatcher .

arg: Object

Obiekt, który ma być przekazywany jako argument do danej metody.

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

ArgumentNullException

method to null.

Uwagi

arg może być null , jeśli argument nie jest potrzebny

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(Delegate, TimeSpan, DispatcherPriority, Object[])

Wykonuje określonego delegata w określonym przedziale czasu na określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher , z z który jest skojarzony.

public:
 System::Object ^ Invoke(Delegate ^ method, TimeSpan timeout, System::Windows::Threading::DispatcherPriority priority, ... cli::array <System::Object ^> ^ args);

public object Invoke (Delegate method, TimeSpan timeout, System.Windows.Threading.DispatcherPriority priority, params object[] args);

member this.Invoke : Delegate * TimeSpan * System.Windows.Threading.DispatcherPriority * obj[] -> obj

Public Function Invoke (method As Delegate, timeout As TimeSpan, priority As DispatcherPriority, ParamArray args As Object()) As Object

Parametry

method: Delegate

Delegat do metody, która przyjmuje parametry określone w argsobiekcie , który jest wypychany do kolejki zdarzeń Dispatcher .

timeout: TimeSpan

priority: DispatcherPriority

Priorytet, względem innych oczekujących operacji w Dispatcher kolejce zdarzeń, z którymi wywoływana jest określona metoda.

args: Object[]

Tablica obiektów, które mają być przekazywane jako argumenty do danej metody. Może to być null.

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Wyjątki

ArgumentNullException

method to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1, a ta metoda została wywołana w wątkach.

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

Uwagi

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(Delegate, TimeSpan, Object[])

Wykonuje określonego delegata w określonym przedziale czasu na określonym priorytetzie z określonymi argumentami synchronicznie w wątku Dispatcher , z z który jest skojarzony.

public:
 System::Object ^ Invoke(Delegate ^ method, TimeSpan timeout, ... cli::array <System::Object ^> ^ args);

public object Invoke (Delegate method, TimeSpan timeout, params object[] args);

member this.Invoke : Delegate * TimeSpan * obj[] -> obj

Public Function Invoke (method As Delegate, timeout As TimeSpan, ParamArray args As Object()) As Object

Parametry

method: Delegate

Delegat do metody, która przyjmuje parametry określone w argsobiekcie , który jest wypychany do kolejki zdarzeń Dispatcher .

timeout: TimeSpan

Maksymalny czas oczekiwania na uruchomienie operacji. Jednak po uruchomieniu operacji zostanie ukończona przed zwróceniem tej metody. Aby określić nieskończone oczekiwanie, użyj wartości -1. W wywołaniu tego samego wątku każda inna wartość ujemna jest konwertowana na -1, co powoduje nieskończone oczekiwanie. W wywołaniu międzywątkowa każda inna wartość ujemna zgłasza wartość ArgumentOutOfRangeException.

args: Object[]

Tablica obiektów, które mają być przekazywane jako argumenty do danej metody. Może to być null , jeśli nie są potrzebne żadne argumenty.

Zwraca

Object

Zwracana wartość z wywoływanego delegata lub null jeśli delegat nie ma wartości zwracanej.

Wyjątki

ArgumentNullException

method to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1 i jest wywoływana między wątkami.

Uwagi

W WPF tylko wątek, który utworzył obiekt DispatcherObject , może uzyskać dostęp do tego obiektu. Na przykład wątek w tle, który jest odłączony od głównego wątku interfejsu użytkownika, nie może zaktualizować zawartości elementu Button utworzonego w wątku interfejsu użytkownika. Aby wątek w tle uzyskiwał dostęp do właściwości Content elementu Button, wątek w tle musi delegować pracę do Dispatcher skojarzonego z wątkiem interfejsu użytkownika. Jest to realizowane przy użyciu polecenia Invoke lub BeginInvoke. Invoke jest synchroniczna i BeginInvoke jest asynchroniczna. Operacja jest dodawana do kolejki zdarzeń Dispatcher określonego DispatcherPriorityobiektu .

Invoke jest operacją synchroniczną; dlatego kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(Action, DispatcherPriority, CancellationToken)

Wykonuje określony Action synchronicznie określony priorytet w wątku Dispatcher skojarzonym z nim.

public:
 void Invoke(Action ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken);

public void Invoke (Action callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken);

member this.Invoke : Action * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken -> unit

Public Sub Invoke (callback As Action, priority As DispatcherPriority, cancellationToken As CancellationToken)

Parametry

callback: Action

Delegat do wywołania za pośrednictwem dyspozytora.

priority: DispatcherPriority

Priorytet określający kolejność wywoływania określonego wywołania zwrotnego względem innych oczekujących operacji w obiekcie Dispatcher.

cancellationToken: CancellationToken

Obiekt wskazujący, czy anulować akcję.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Dotyczy

Invoke(DispatcherPriority, Delegate)

Wykonuje określony delegat synchronicznie z określonym priorytetem w wątku Dispatcher , z który jest skojarzony.

public:
 System::Object ^ Invoke(System::Windows::Threading::DispatcherPriority priority, Delegate ^ method);

[System.ComponentModel.Browsable(false)]
public object Invoke (System.Windows.Threading.DispatcherPriority priority, Delegate method);

[<System.ComponentModel.Browsable(false)>]
member this.Invoke : System.Windows.Threading.DispatcherPriority * Delegate -> obj

Public Function Invoke (priority As DispatcherPriority, method As Delegate) As Object

Parametry

priority: DispatcherPriority

Priorytet, z którym jest wywoływana określona metoda, względem innych oczekujących operacji w kolejce zdarzeń Dispatcher .

method: Delegate

Delegat do metody, która nie przyjmuje żadnych argumentów, które są wypychane do kolejki zdarzeń Dispatcher .

Zwraca

Object

Wartość zwracana z delegata wywoływanego lub null jeśli delegat nie ma wartości zwracanej.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentException

priority jest równe Inactive.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

ArgumentNullException

method to null.

Przykłady

Poniższy przykład umieszcza delegata na Dispatcher obiekcie przy Normal użyciu polecenia Invoke.

// Places the delegate onto the UI Thread's Dispatcher
private void timer_Elapsed(object sender, ElapsedEventArgs e)
{
    // Place delegate on the Dispatcher.
    this.Dispatcher.Invoke(DispatcherPriority.Normal,
        new TimerDispatcherDelegate(TimerWorkItem));
}

' Places the delegate onto the UI Thread's Dispatcher
Private Sub timer_Elapsed(ByVal sender As Object, ByVal e As ElapsedEventArgs)
    ' Place delegate on the Dispatcher.
    Me.Dispatcher.Invoke(DispatcherPriority.Normal, New TimerDispatcherDelegate(AddressOf TimerWorkItem))
End Sub

Uwagi

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(Delegate, Object[])

Wykonuje określony delegat z określonymi argumentami synchronicznie w wątku, z który Dispatcher jest skojarzony.

public:
 System::Object ^ Invoke(Delegate ^ method, ... cli::array <System::Object ^> ^ args);

public object Invoke (Delegate method, params object[] args);

member this.Invoke : Delegate * obj[] -> obj

Public Function Invoke (method As Delegate, ParamArray args As Object()) As Object

Parametry

method: Delegate

Delegat do metody, która przyjmuje parametry określone w argselemecie , który jest wypychany do kolejki zdarzeń Dispatcher .

args: Object[]

Tablica obiektów, które mają być przekazywane jako argumenty do danej metody. Może to być null.

Zwraca

Object

Wartość zwracana z delegata wywoływanego lub null jeśli delegat nie ma wartości zwracanej.

Uwagi

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke(Action, DispatcherPriority)

Wykonuje określony Action synchronicznie z określonym priorytetem w wątku, z który Dispatcher jest skojarzony.

public:
 void Invoke(Action ^ callback, System::Windows::Threading::DispatcherPriority priority);

public void Invoke (Action callback, System.Windows.Threading.DispatcherPriority priority);

member this.Invoke : Action * System.Windows.Threading.DispatcherPriority -> unit

Public Sub Invoke (callback As Action, priority As DispatcherPriority)

Parametry

callback: Action

Delegat do wywołania za pośrednictwem dyspozytora.

priority: DispatcherPriority

Priorytet określający kolejność wywoływania określonego wywołania zwrotnego względem innych oczekujących operacji w obiekcie Dispatcher.

Dotyczy

Invoke(Action)

Wykonuje określony Action synchronicznie w wątku, z który Dispatcher jest skojarzony.

public:
 void Invoke(Action ^ callback);

public void Invoke (Action callback);

member this.Invoke : Action -> unit

Public Sub Invoke (callback As Action)

Parametry

callback: Action

Delegat do wywołania za pośrednictwem dyspozytora.

Uwagi

Domyślny priorytet to DispatcherPriority.Send.

Dotyczy

Invoke(Delegate, DispatcherPriority, Object[])

Wykonuje określony delegat z określonym priorytetem z określonymi argumentami synchronicznie w wątku, z który Dispatcher jest skojarzony.

public:
 System::Object ^ Invoke(Delegate ^ method, System::Windows::Threading::DispatcherPriority priority, ... cli::array <System::Object ^> ^ args);

public object Invoke (Delegate method, System.Windows.Threading.DispatcherPriority priority, params object[] args);

member this.Invoke : Delegate * System.Windows.Threading.DispatcherPriority * obj[] -> obj

Public Function Invoke (method As Delegate, priority As DispatcherPriority, ParamArray args As Object()) As Object

Parametry

method: Delegate

Delegat do metody, która przyjmuje parametry określone w argselemecie , który jest wypychany do kolejki zdarzeń Dispatcher .

priority: DispatcherPriority

Priorytet, z którym jest wywoływana określona metoda, względem innych oczekujących operacji w kolejce zdarzeń Dispatcher .

args: Object[]

Tablica obiektów, które mają być przekazywane jako argumenty do danej metody. Może to być null.

Zwraca

Object

Wartość zwracana z delegata wywoływanego lub null jeśli delegat nie ma wartości zwracanej.

Uwagi

Invoke jest operacją synchroniczną; w związku z tym kontrolka nie powróci do obiektu wywołującego dopiero po powrocie wywołania zwrotnego.

Dotyczy

Invoke<TResult>(Func<TResult>)

Wykonuje określony Func<TResult> synchronicznie w wątku, z który Dispatcher jest skojarzony.

public:
generic <typename TResult>
 TResult Invoke(Func<TResult> ^ callback);

public TResult Invoke<TResult> (Func<TResult> callback);

member this.Invoke : Func<'Result> -> 'Result

Public Function Invoke(Of TResult) (callback As Func(Of TResult)) As TResult

Parametry typu

TResult

Zwracany typ wartości określonego delegata.

Parametry

callback: Func<TResult>

Delegat do wywołania za pośrednictwem dyspozytora.

Zwraca

TResult

Wartość zwrócona przez callback.

Dotyczy

Invoke<TResult>(Func<TResult>, DispatcherPriority)

Wykonuje określony Func<TResult> synchronicznie z określonym priorytetem w wątku, z który Dispatcher jest skojarzony.

public:
generic <typename TResult>
 TResult Invoke(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority);

public TResult Invoke<TResult> (Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority);

member this.Invoke : Func<'Result> * System.Windows.Threading.DispatcherPriority -> 'Result

Public Function Invoke(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority) As TResult

Parametry typu

TResult

Zwracany typ wartości określonego delegata.

Parametry

callback: Func<TResult>

Delegat do wywołania za pośrednictwem dyspozytora.

priority: DispatcherPriority

Priorytet określający kolejność wywoływania określonego wywołania zwrotnego względem innych oczekujących operacji w obiekcie Dispatcher.

Zwraca

TResult

Wartość zwrócona przez callback.

Dotyczy

Invoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)

Wykonuje określony Func<TResult> synchronicznie z określonym priorytetem w wątku, z który Dispatcher jest skojarzony.

public:
generic <typename TResult>
 TResult Invoke(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken);

public TResult Invoke<TResult> (Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken);

member this.Invoke : Func<'Result> * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken -> 'Result

Public Function Invoke(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority, cancellationToken As CancellationToken) As TResult

Parametry typu

TResult

Zwracany typ wartości określonego delegata.

Parametry

callback: Func<TResult>

Delegat do wywołania za pośrednictwem dyspozytora.

priority: DispatcherPriority

Priorytet określający kolejność wywoływania określonego wywołania zwrotnego względem innych oczekujących operacji w obiekcie Dispatcher.

cancellationToken: CancellationToken

Obiekt wskazujący, czy anulować operację.

Zwraca

TResult

Wartość zwrócona przez callback.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy

Invoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken, TimeSpan)

Wykonuje określony Func<TResult> synchronicznie z określonym priorytetem w wątku, z który Dispatcher jest skojarzony.

public:
generic <typename TResult>
 TResult Invoke(Func<TResult> ^ callback, System::Windows::Threading::DispatcherPriority priority, System::Threading::CancellationToken cancellationToken, TimeSpan timeout);

public TResult Invoke<TResult> (Func<TResult> callback, System.Windows.Threading.DispatcherPriority priority, System.Threading.CancellationToken cancellationToken, TimeSpan timeout);

member this.Invoke : Func<'Result> * System.Windows.Threading.DispatcherPriority * System.Threading.CancellationToken * TimeSpan -> 'Result

Public Function Invoke(Of TResult) (callback As Func(Of TResult), priority As DispatcherPriority, cancellationToken As CancellationToken, timeout As TimeSpan) As TResult

Parametry typu

TResult

Zwracany typ wartości określonego delegata.

Parametry

callback: Func<TResult>

Delegat do wywołania za pośrednictwem dyspozytora.

priority: DispatcherPriority

Priorytet określający kolejność wywoływania określonego wywołania zwrotnego względem innych oczekujących operacji w obiekcie Dispatcher.

cancellationToken: CancellationToken

Obiekt wskazujący, czy anulować operację.

timeout: TimeSpan

Maksymalny czas oczekiwania na rozpoczęcie operacji. Po rozpoczęciu operacji zostanie ona ukończona przed zwróceniem tej metody. Aby określić nieskończone oczekiwanie, użyj wartości -1. W wywołaniu tego samego wątku każda inna wartość ujemna jest konwertowana na -1, co powoduje nieskończone oczekiwanie. W wywołaniu międzywątkowa każda inna wartość ujemna ArgumentOutOfRangeExceptionzgłasza wartość .

Zwraca

TResult

Wartość zwrócona przez callback.

Wyjątki

ArgumentNullException

callback to null.

ArgumentOutOfRangeException

timeout jest liczbą ujemną inną niż -1, a metoda została wywołana między wątkami.

InvalidEnumArgumentException

priority nie jest prawidłowym priorytetem.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Dotyczy

Udostępnij za pośrednictwem

Dispatcher.Invoke Metoda

Definicja

Przeciążenia

Przykłady

Uwagi

Invoke(DispatcherPriority, TimeSpan, Delegate, Object, Object[])

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(DispatcherPriority, TimeSpan, Delegate, Object)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(DispatcherPriority, Delegate, Object, Object[])

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(Action, DispatcherPriority, CancellationToken, TimeSpan)

Parametry

Wyjątki

Dotyczy

Invoke(DispatcherPriority, TimeSpan, Delegate)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(DispatcherPriority, Delegate, Object)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(Delegate, TimeSpan, DispatcherPriority, Object[])

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(Delegate, TimeSpan, Object[])

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Invoke(Action, DispatcherPriority, CancellationToken)

Parametry

Wyjątki

Dotyczy

Invoke(DispatcherPriority, Delegate)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

Invoke(Delegate, Object[])

Parametry

Zwraca

Uwagi

Dotyczy

Invoke(Action, DispatcherPriority)

Parametry

Dotyczy

Invoke(Action)

Parametry

Uwagi

Dotyczy

Invoke(Delegate, DispatcherPriority, Object[])

Parametry

Zwraca

Uwagi

Dotyczy