Dispatcher Třída

Definice

Poskytuje služby pro správu fronty pracovních položek pro vlákno.Provides services for managing the queue of work items for a thread.

public ref class Dispatcher sealed
public sealed class Dispatcher
type Dispatcher = class
Public NotInheritable Class Dispatcher
Dědičnost
Dispatcher

Příklady

Následující příklad ukazuje, jak umístit operaci do Dispatcher .The following example shows how to place an operation onto a Dispatcher. Úplný zdrojový kód tohoto příkladu naleznete v tématu aplikace s jedním vláknem s ukázkou výpočtů Long-Running.For the full source code of this example, see Single-Threaded Application with Long-Running Calculation Sample.

Nejprve je vytvořen delegát, který nepřijímá žádné argumenty.First, a delegate is created that accepts no arguments.

public delegate void NextPrimeDelegate();
Public Delegate Sub NextPrimeDelegate()

Pak BeginInvoke(DispatcherPriority, Delegate) se zavolá.Next, BeginInvoke(DispatcherPriority, Delegate) is called. Toto volání má BeginInvoke(DispatcherPriority, Delegate) dva parametry: priorita, která je nastavena na DispatcherPriority.Normal a zpětné volání, které je předáno prostřednictvím instance delegáta NextPrimeDelegate .This call to BeginInvoke(DispatcherPriority, Delegate) takes two parameters: the priority, which is set to DispatcherPriority.Normal, and the callback, which is passed in through an instance of the delegate NextPrimeDelegate.

startStopButton.Dispatcher.BeginInvoke(
    DispatcherPriority.Normal,
    new NextPrimeDelegate(CheckNextNumber));
startStopButton.Dispatcher.BeginInvoke(DispatcherPriority.Normal, New NextPrimeDelegate(AddressOf CheckNextNumber))

Poznámky

DispatcherUdržuje prioritní frontu pracovních položek pro konkrétní vlákno.The Dispatcher maintains a prioritized queue of work items for a specific thread.

Když Dispatcher je vytvořen ve vlákně, je ten Dispatcher , který může být přidružen ke vláknu, i když Dispatcher je vypnutý.When a Dispatcher is created on a thread, it becomes the only Dispatcher that can be associated with the thread, even if the Dispatcher is shut down.

Pokud se pokusíte získat CurrentDispatcher pro aktuální vlákno a Dispatcher není přidruženo k vláknu, Dispatcher bude vytvořena.If you attempt to get the CurrentDispatcher for the current thread and a Dispatcher is not associated with the thread, a Dispatcher will be created. A vytvoří Dispatcher se také při vytvoření DispatcherObject .A Dispatcher is also created when you create a DispatcherObject. Pokud vytvoříte Dispatcher ve vlákně na pozadí, nezapomeňte ukončit dispečera před ukončením vlákna.If you create a Dispatcher on a background thread, be sure to shut down the dispatcher before exiting the thread.

Pokud Dispatcher je vypnutý, nejde ho restartovat.If a Dispatcher is shut down, it cannot be restarted.

V WPF je k DispatcherObject dispozici pouze objekt, ke kterému Dispatcher je přidružen.In WPF, a DispatcherObject can only be accessed by the Dispatcher it is associated with. Vlákno na pozadí například nemůže aktualizovat obsah Button , který je přidružen ke Dispatcher VLÁKNU uživatelského rozhraní.For example, a background thread cannot update the contents of a Button that is associated with the Dispatcher on the UI thread. Aby vlákno na pozadí mělo přístup k Content vlastnosti Button , vlákno na pozadí musí delegovat práci na Dispatcher přidružený k vláknu uživatelského rozhraní.In order for the background thread to access the Content property of the Button, the background thread must delegate the work to the Dispatcher associated with the UI thread. K tomu je možné použít buď Invoke nebo BeginInvoke .This is accomplished by using either Invoke or BeginInvoke. Invoke je synchronní a BeginInvoke je asynchronní.Invoke is synchronous and BeginInvoke is asynchronous. Operace je přidána do fronty v Dispatcher zadaném umístění DispatcherPriority .The operation is added to the queue of the Dispatcher at the specified DispatcherPriority.

Pokud BeginInvoke je volána na Dispatcher , který obsahuje vypnutí, vlastnost status vráceného DispatcherOperation je nastavena na Aborted .If BeginInvoke is called on a Dispatcher that has shut down, the status property of the returned DispatcherOperation is set to Aborted.

Všechny metody na Dispatcher , s výjimkou DisableProcessing , jsou bez vlákna.All of the methods on Dispatcher, with the exception of DisableProcessing, are free-threaded.

Objekty, které jsou odvozeny z DispatcherObject mají spřažení vláken.Objects that derive from DispatcherObject have thread affinity.

Objekty, které jsou odvozeny z Freezable , jsou při zmrazení bez vlákna.Objects that derive from Freezable are free-threaded when they are frozen. Další informace najdete v tématu Přehled objektů Freezable.For more information, see Freezable Objects Overview.

Vlastnosti

CurrentDispatcher

Získá Dispatcher pro vlákno aktuálně prováděné a vytvoří nový, pokud ještě není Dispatcher přidružen k vláknu.Gets the Dispatcher for the thread currently executing and creates a new Dispatcher if one is not already associated with the thread.

HasShutdownFinished

Určuje, zda Dispatcher bylo dokončeno vypínání.Determines whether the Dispatcher has finished shutting down.

HasShutdownStarted

Určuje, zda se má Dispatcher vypínat.Determines whether the Dispatcher is shutting down.

Hooks

Získá kolekci háčků, které poskytují další informace o události Dispatcher .Gets the collection of hooks that provide additional event information about the Dispatcher.

Thread

Získá vlákno, Dispatcher ke kterému je přidruženo.Gets the thread this Dispatcher is associated with.

Metody

BeginInvoke(Delegate, DispatcherPriority, Object[])

Provede asynchronní spuštění zadaného delegáta se zadanými argumenty v zadané prioritě ve vlákně, Dispatcher v němž byl vytvořen.Executes the specified delegate asynchronously with the specified arguments, at the specified priority, on the thread that the Dispatcher was created on.

BeginInvoke(Delegate, Object[])

Provede asynchronní provedení zadaného delegáta zadanými argumenty ve vlákně, ve kterém Dispatcher byla vytvořena.Executes the specified delegate asynchronously with the specified arguments on the thread that the Dispatcher was created on.

BeginInvoke(DispatcherPriority, Delegate)

Provede asynchronní spuštění zadaného delegáta v zadané prioritě ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate asynchronously at the specified priority on the thread the Dispatcher is associated with.

BeginInvoke(DispatcherPriority, Delegate, Object)

Provede asynchronní spuštění zadaného delegáta v zadané prioritě a se zadaným argumentem ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate asynchronously at the specified priority and with the specified argument on the thread the Dispatcher is associated with.

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

Provede asynchronní spuštění zadaného delegáta v zadané prioritě a se zadaným polem argumentů ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate asynchronously at the specified priority and with the specified array of arguments on the thread the Dispatcher is associated with.

BeginInvokeShutdown(DispatcherPriority)

Inicializuje Dispatcher asynchronní vypnutí.Initiates shutdown of the Dispatcher asynchronously.

CheckAccess()

Určuje, zda je volající vlákno vláknem přidruženým k tomuto Dispatcher .Determines whether the calling thread is the thread associated with this Dispatcher.

DisableProcessing()

Zakáže zpracování Dispatcher fronty.Disables processing of the Dispatcher queue.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
ExitAllFrames()

Požaduje, aby všechny snímky byly ukončeny, včetně vnořených snímků.Requests that all frames exit, including nested frames.

FromThread(Thread)

Získá Dispatcher pro zadané vlákno.Gets the Dispatcher for the specified thread.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
Invoke(Action)

Spustí zadanou Action synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified Action synchronously on the thread the Dispatcher is associated with.

Invoke(Action, DispatcherPriority)

Spustí zadanou Action synchronně na zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Action synchronously at the specified priority on the thread the Dispatcher is associated with.

Invoke(Action, DispatcherPriority, CancellationToken)

Spustí zadanou Action synchronně na zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Action synchronously at the specified priority on the thread the Dispatcher is associated with.

Invoke(Action, DispatcherPriority, CancellationToken, TimeSpan)

Spustí zadanou Action synchronně na zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Action synchronously at the specified priority on the thread the Dispatcher is associated with.

Invoke(Delegate, DispatcherPriority, Object[])

Spustí zadaného delegáta v zadané prioritě se zadanými argumenty synchronně ve vlákně, ke které Dispatcher je přidruženo.Executes the specified delegate at the specified priority with the specified arguments synchronously on the thread the Dispatcher is associated with.

Invoke(Delegate, Object[])

Spustí zadaného delegáta se zadanými argumenty synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate with the specified arguments synchronously on the thread the Dispatcher is associated with.

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

Spustí zadaného delegáta v rámci určeného časového rozsahu na zadané prioritě se zadanými argumenty synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate within the designated time span at the specified priority with the specified arguments synchronously on the thread the Dispatcher is associated with.

Invoke(Delegate, TimeSpan, Object[])

Spustí zadaného delegáta v rámci určeného časového rozsahu na zadané prioritě se zadanými argumenty synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate within the designated time span at the specified priority with the specified arguments synchronously on the thread the Dispatcher is associated with.

Invoke(DispatcherPriority, Delegate)

Spustí zadaného delegáta synchronně v zadané prioritě ve vlákně, ke kterému Dispatcher je přidružena.Executes the specified delegate synchronously at the specified priority on the thread that the Dispatcher is associated with.

Invoke(DispatcherPriority, Delegate, Object)

Spustí zadaného delegáta v zadané prioritě se zadaným argumentem synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate at the specified priority with the specified argument synchronously on the thread the Dispatcher is associated with.

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

Spustí zadaného delegáta v zadané prioritě se zadanými argumenty synchronně ve vlákně, ke které Dispatcher je přidruženo.Executes the specified delegate at the specified priority with the specified arguments synchronously on the thread the Dispatcher is associated with.

Invoke(DispatcherPriority, TimeSpan, Delegate)

Spustí zadaného delegáta synchronně v zadané prioritě a se zadanou hodnotou časového limitu ve vlákně, kterou Dispatcher jste vytvořili.Executes the specified delegate synchronously at the specified priority and with the specified time-out value on the thread the Dispatcher was created.

Invoke(DispatcherPriority, TimeSpan, Delegate, Object)

Spustí zadaného delegáta v zadané prioritě se zadaným argumentem synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified delegate at the specified priority with the specified argument synchronously on the thread the Dispatcher is associated with.

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

Spustí zadaného delegáta v zadané prioritě se zadanými argumenty synchronně ve vlákně, ke které Dispatcher je přidruženo.Executes the specified delegate at the specified priority with the specified arguments synchronously on the thread the Dispatcher is associated with.

Invoke<TResult>(Func<TResult>)

Spustí zadanou Func<TResult> synchronně ve vlákně, ke Dispatcher kterému je přidružena.Executes the specified Func<TResult> synchronously on the thread the Dispatcher is associated with.

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

Spustí zadanou Func<TResult> synchronně na zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Func<TResult> synchronously at the specified priority on the thread the Dispatcher is associated with.

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

Spustí zadanou Func<TResult> synchronně na zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Func<TResult> synchronously at the specified priority on the thread the Dispatcher is associated with.

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

Spustí zadanou Func<TResult> synchronně na zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Func<TResult> synchronously at the specified priority on the thread the Dispatcher is associated with.

InvokeAsync(Action)

Provede asynchronně zadanou Action hodnotu ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Action asynchronously on the thread the Dispatcher is associated with.

InvokeAsync(Action, DispatcherPriority)

Provede asynchronní zpracování Action v zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Action asynchronously at the specified priority on the thread the Dispatcher is associated with.

InvokeAsync(Action, DispatcherPriority, CancellationToken)

Provede asynchronní zpracování Action v zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Action asynchronously at the specified priority on the thread the Dispatcher is associated with.

InvokeAsync<TResult>(Func<TResult>)

Provede asynchronně zadanou Func<TResult> hodnotu ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Func<TResult> asynchronously on the thread the Dispatcher is associated with.

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

Provede asynchronní zpracování Func<TResult> v zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Func<TResult> asynchronously at the specified priority on the thread the Dispatcher is associated with.

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

Provede asynchronní zpracování Func<TResult> v zadané prioritě ve vlákně, ke které Dispatcher je přidruženo.Executes the specified Func<TResult> asynchronously at the specified priority on the thread the Dispatcher is associated with.

InvokeShutdown()

Inicializuje proces vypnutí Dispatcher synchronně.Initiates the shutdown process of the Dispatcher synchronously.

MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
PushFrame(DispatcherFrame)

Vstupuje do smyčky Execute.Enters an execute loop.

Run()

Nahraje hlavní rámec spuštění ve frontě událostí Dispatcher .Pushes the main execution frame on the event queue of the Dispatcher.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)
ValidatePriority(DispatcherPriority, String)

Určuje, zda DispatcherPriority je zadaná platná priorita.Determines whether the specified DispatcherPriority is a valid priority.

VerifyAccess()

Určuje, zda má volající vlákno přístup Dispatcher .Determines whether the calling thread has access to this Dispatcher.

Yield()

Vytvoří await objekt, který asynchronně poskytne řízení zpět aktuálnímu dispečeru a poskytuje příležitost pro zpracování dalších událostí dispečera.Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events.

Yield(DispatcherPriority)

Vytvoří await objekt, který asynchronně poskytne řízení zpět aktuálnímu dispečeru a poskytuje příležitost pro zpracování dalších událostí dispečera.Creates an awaitable object that asynchronously yields control back to the current dispatcher and provides an opportunity for the dispatcher to process other events. Práce, ke které dojde, když se ovládací prvek vrátí do kódu, který čeká na výsledek této metody, se naplánuje se zadanou prioritou.The work that occurs when control returns to the code awaiting the result of this method is scheduled with the specified priority.

Události

ShutdownFinished

Vyvolá se v případě, že se Dispatcher dokončí vypínání.Occurs when the Dispatcher finishes shutting down.

ShutdownStarted

Vyvolá se v případě, že je Dispatcher zahájeno vypnutí.Occurs when the Dispatcher begins to shut down.

UnhandledException

Nastane, pokud je vyvolána výjimka vlákna a není zachycena při provádění delegáta způsobem Invoke nebo BeginInvoke .Occurs when a thread exception is thrown and uncaught during execution of a delegate by way of Invoke or BeginInvoke.

UnhandledExceptionFilter

Nastane, pokud je vyvolána výjimka vlákna a není zachycena při provádění delegáta způsobem Invoke nebo BeginInvoke ve fázi filtru.Occurs when a thread exception is thrown and uncaught during execution of a delegate by way of Invoke or BeginInvoke when in the filter stage.

Metody rozšíření

BeginInvoke(Dispatcher, Action)

Provede asynchronní spuštění zadaného delegáta s normální prioritou na vlákně, ve kterém Dispatcher byla vytvořena.Executes the specified delegate asynchronously with normal priority on the thread that the specified Dispatcher was created on.

BeginInvoke(Dispatcher, Action, DispatcherPriority)

Provede asynchronní spuštění zadaného delegáta s určenou prioritou ve vlákně, Dispatcher v němž byl vytvořen.Executes the specified delegate asynchronously with the specified priority on the thread that the specified Dispatcher was created on.

Invoke(Dispatcher, Action)

Provede synchronní spuštění zadaného delegáta s normální prioritou ve vlákně, ve kterém Dispatcher byla vytvořena.Executes the specified delegate synchronously with normal priority on the thread that the specified Dispatcher was created on.

Invoke(Dispatcher, Action, TimeSpan)

Provede synchronní spuštění zadaného delegáta ve vlákně, v němž Dispatcher byl vytvořen, a zastaví provádění po zadaném časovém limitu.Executes the specified delegate synchronously on the thread that the specified Dispatcher was created on, and stops execution after the specified time-out period.

Invoke(Dispatcher, Action, TimeSpan, DispatcherPriority)

Provede synchronní spuštění zadaného delegáta se zadanou prioritou ve vlákně, Dispatcher v němž byl vytvořen, a zastaví provádění po zadaném časovém limitu.Executes the specified delegate synchronously with the specified priority on the thread that the specified Dispatcher was created on, and stops execution after the specified time-out period.

Invoke(Dispatcher, Action, DispatcherPriority)

Provede synchronní spuštění zadaného delegáta s určenou prioritou ve vlákně, Dispatcher v němž byl vytvořen.Executes the specified delegate synchronously with the specified priority on the thread that the specified Dispatcher was created on.

Platí pro