Dispatcher.Invoke Yöntem

Tanım

Ad Alanı:

System.Windows.Threading

Bütünleştirilmiş Kod:

WindowsBase.dll

Belirtilen temsilciyi ilişkili iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

Aşırı Yüklemeler

Invoke(DispatcherPriority, TimeSpan, Delegate, Object, Object[])	Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenlerle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke(DispatcherPriority, TimeSpan, Delegate, Object)	Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke(DispatcherPriority, Delegate, Object, Object[])	Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenlerle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke(Action, DispatcherPriority, CancellationToken, TimeSpan)	Belirtilen Action değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.
Invoke(DispatcherPriority, TimeSpan, Delegate)	Belirtilen temsilciyi belirtilen önceliğe ve oluşturulan iş parçacığında Dispatcher belirtilen zaman aşımı değeriyle zaman uyumlu olarak yürütür.
Invoke(DispatcherPriority, Delegate, Object)	Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke(Delegate, TimeSpan, DispatcherPriority, Object[])	Belirtilen zaman aralığı içinde belirtilen temsilciyi belirtilen önceliğe göre, ilişkili iş parçacığında Dispatcher belirtilen bağımsız değişkenlerle zaman uyumlu olarak yürütür.
Invoke(Delegate, TimeSpan, Object[])	Belirtilen zaman aralığı içinde belirtilen temsilciyi belirtilen önceliğe göre, ilişkili iş parçacığında Dispatcher belirtilen bağımsız değişkenlerle zaman uyumlu olarak yürütür.
Invoke(Action, DispatcherPriority, CancellationToken)	Belirtilen Action değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.
Invoke(DispatcherPriority, Delegate)	Belirtilen temsilciyi ilişkili iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.
Invoke(Delegate, Object[])	Belirtilen temsilciyi belirtilen bağımsız değişkenlerle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke(Action, DispatcherPriority)	Belirtilen Action değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.
Invoke(Action)	Belirtilen Action öğesini ilişkili olduğu iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke(Delegate, DispatcherPriority, Object[])	Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenlerle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke<TResult>(Func<TResult>)	Belirtilen Func<TResult> öğesini ilişkili olduğu iş parçacığında Dispatcher zaman uyumlu olarak yürütür.
Invoke<TResult>(Func<TResult>, DispatcherPriority)	Belirtilen Func<TResult> değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.
Invoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)	Belirtilen Func<TResult> değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.
Invoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken, TimeSpan)	Belirtilen Func<TResult> değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

Örnekler

Aşağıdaki örnek, kullanarak Invokeadresine bir DispatcherNormal temsilci yerleştirir.

// 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

Açıklamalar

WPF'de, yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana ui iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin arka plan iş parçacığının ui iş parçacığıyla ilişkilendirilmiş çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumlu ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri arama döndürülene kadar denetim çağıran nesneye dönmez.

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

Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenlerle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

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

Parametreler

priority

DispatcherPriority

Belirtilen yöntemin çağrıldığı olay kuyruğundaki Dispatcher diğer bekleyen işlemlere göre öncelik.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. İşlem başlatıldıktan sonra, bu yöntem dönmeden önce tamamlanır. Sonsuz bir bekleme belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. çapraz iş parçacığı çağrısında, diğer negatif değerler bir ArgumentOutOfRangeExceptionoluşturur.

method

Delegate

Olay kuyruğuna gönderilen birden çok bağımsız değişkeni alan bir yöntemin Dispatcher temsilcisi.

arg

Object

Belirtilen yönteme bağımsız değişken olarak geçirilebilir bir nesne.

args

Object[]

Belirtilen yönteme bağımsız değişken olarak geçirilebilir bir nesne dizisi.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli DispatcherPrioritybir değil.

ArgumentNullException

method, null değeridir.

ArgumentOutOfRangeException

timeout -1 dışında bir negatif sayıdır ve bu yöntem iş parçacıkları arasında çağrıldı.

Açıklamalar

arg bir bağımsız değişken gerekli değilse olabilir null .

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri çağırma döndürülene kadar denetim çağıran nesnesine dönmez.

Invoke(DispatcherPriority, TimeSpan, Delegate, Object)

Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

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

Parametreler

priority

DispatcherPriority

Belirtilen yöntemin çağrıldığı olay kuyruğundaki Dispatcher diğer bekleyen işlemlere göre öncelik.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. İşlem başlatıldıktan sonra, bu yöntem dönmeden önce tamamlanır. Sonsuz bir bekleme belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. çapraz iş parçacığı çağrısında, diğer negatif değerler bir ArgumentOutOfRangeExceptionoluşturur.

method

Delegate

Olay kuyruğuna gönderilen birden çok bağımsız değişkeni alan bir yöntemin Dispatcher temsilcisi.

arg

Object

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne. Bu, bağımsız değişken gerekmiyorsa olabilir null .

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

ArgumentNullException

method, null değeridir.

Açıklamalar

argbir bağımsız değişken gerekli değilse olabilir null

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri çağırma döndürülene kadar denetim çağıran nesnesine dönmez.

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

Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenlerle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

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

Parametreler

priority

DispatcherPriority

Belirtilen yöntemin çağrıldığı olay kuyruğundaki Dispatcher diğer bekleyen işlemlere göre öncelik.

method

Delegate

Olay kuyruğuna gönderilen birden çok bağımsız değişkeni alan bir yöntemin Dispatcher temsilcisi.

arg

Object

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne.

args

Object[]

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne dizisi.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

ArgumentNullException

method, null değeridir.

Açıklamalar

argbir bağımsız değişken gerekli değilse olabilir null

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri çağırma döndürülene kadar denetim çağıran nesnesine dönmez.

Invoke(Action, DispatcherPriority, CancellationToken, TimeSpan)

Belirtilen Action değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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)

Parametreler

callback

Action

Dağıtıcı aracılığıyla çağrılacak bir Eylem temsilcisi.

priority

DispatcherPriority

Belirtilen geri çağırmanın içindeki diğer bekleyen işlemlere Dispatchergöre çağrılma sırasını belirleyen öncelik.

cancellationToken

CancellationToken

Eylemin iptal edilip edilmeyeceğini gösteren nesne.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. İşlem başlatıldıktan sonra, bu yöntem dönmeden önce tamamlanır. Sonsuz bir bekleme belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. çapraz iş parçacığı çağrısında, diğer negatif değerler bir ArgumentOutOfRangeExceptionoluşturur.

Özel durumlar

ArgumentNullException

callback, null değeridir.

ArgumentOutOfRangeException

timeout -1 dışında bir negatif sayıdır ve bu yöntem iş parçacıkları arasında çağrıldı.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Invoke(DispatcherPriority, TimeSpan, Delegate)

Belirtilen temsilciyi belirtilen önceliğe ve oluşturulan iş parçacığında Dispatcher belirtilen zaman aşımı değeriyle zaman uyumlu olarak yürütür.

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

Parametreler

priority

DispatcherPriority

Belirtilen yöntemin çağrıldığı olay kuyruğundaki Dispatcher diğer bekleyen işlemlere göre öncelik.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. İşlem başlatıldıktan sonra, bu yöntem dönmeden önce tamamlanır. Sonsuz bir bekleme belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. çapraz iş parçacığı çağrısında, diğer negatif değerler bir ArgumentOutOfRangeExceptionoluşturur.

method

Delegate

Olay kuyruğuna gönderilen bağımsız değişken içermeyen bir yöntemin Dispatcher temsilcisi.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentNullException

method, null değeridir.

ArgumentOutOfRangeException

timeout -1 dışında bir negatif sayıdır ve bu yöntem iş parçacıkları arasında çağrıldı.

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

Açıklamalar

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri çağırma döndürülene kadar denetim çağıran nesnesine dönmez.

Invoke(DispatcherPriority, Delegate, Object)

Belirtilen temsilciyi belirtilen önceliğe göre belirtilen bağımsız değişkenle ilişkilendirilen iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

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

Parametreler

priority

DispatcherPriority

Belirtilen yöntemin çağrıldığı olay kuyruğundaki Dispatcher diğer bekleyen işlemlere göre öncelik.

method

Delegate

Olay kuyruğuna gönderilen tek bir bağımsız değişkeni alan yöntemin Dispatcher temsilcisi.

arg

Object

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

ArgumentNullException

method, null değeridir.

Açıklamalar

argbir bağımsız değişken gerekli değilse olabilir null

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri çağırma döndürülene kadar denetim çağıran nesnesine dönmez.

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

Belirtilen zaman aralığı içinde belirtilen temsilciyi belirtilen önceliğe göre, ilişkili iş parçacığında Dispatcher belirtilen bağımsız değişkenlerle zaman uyumlu olarak yürütür.

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

Parametreler

method

Delegate

içinde belirtilen argsve olay kuyruğuna gönderilen parametreleri alan bir yöntemin Dispatcher temsilcisi.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. İşlem başlatıldıktan sonra, bu yöntem dönmeden önce tamamlanır. Sonsuz bir bekleme belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. çapraz iş parçacığı çağrısında, diğer negatif değerler bir ArgumentOutOfRangeExceptionoluşturur.

priority

DispatcherPriority

Belirtilen yöntemin çağrıldığı olay kuyruğundaki Dispatcher diğer bekleyen işlemlere göre öncelik.

args

Object[]

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne dizisi. olabilir null.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Özel durumlar

ArgumentNullException

method, null değeridir.

ArgumentOutOfRangeException

timeout -1 dışında bir negatif sayıdır ve bu yöntem iş parçacıkları arasında çağrıldı.

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

Açıklamalar

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri çağırma döndürülene kadar denetim çağıran nesnesine dönmez.

Invoke(Delegate, TimeSpan, Object[])

Belirtilen zaman aralığı içinde belirtilen temsilciyi belirtilen önceliğe göre, ilişkili iş parçacığında Dispatcher belirtilen bağımsız değişkenlerle zaman uyumlu olarak yürütür.

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

Parametreler

method

Delegate

içinde belirtilen argsve olay kuyruğuna gönderilen parametreleri alan bir yöntemin Dispatcher temsilcisi.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. Ancak, işlem başladıktan sonra bu yöntem döndürülmeden önce tamamlanır. Sonsuz bir bekleme belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. çapraz iş parçacığı çağrısında, diğer negatif değerler bir ArgumentOutOfRangeExceptionoluşturur.

args

Object[]

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne dizisi. Bağımsız değişken gerekmiyorsa olabilir null .

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yok.

Özel durumlar

ArgumentNullException

method, null değeridir.

ArgumentOutOfRangeException

timeout -1 dışında bir negatif sayıdır ve iş parçacıkları arasında çağrılıyorsunuz.

Açıklamalar

WPF'de yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana kullanıcı arabirimi iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin, arka plan iş parçacığının ui iş parçacığıyla ilişkili çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumludur ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri arama döndürülene kadar denetim çağıran nesnesine dönmez.

Invoke(Action, DispatcherPriority, CancellationToken)

Belirtilen Action değeri, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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)

Parametreler

callback

Action

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

priority

DispatcherPriority

Belirtilen geri çağırmanın içindeki diğer bekleyen işlemlere Dispatchergöre çağrılma sırasını belirleyen öncelik.

cancellationToken

CancellationToken

Eylemin iptal edilip edilmeyeceğini gösteren nesne.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Invoke(DispatcherPriority, Delegate)

Belirtilen temsilciyi ilişkili iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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

Parametreler

priority

DispatcherPriority

Olay kuyruğundaki diğer bekleyen işlemlere göre belirtilen yöntemin Dispatcher çağrıldığı öncelik.

method

Delegate

Olay kuyruğuna gönderilen bağımsız değişken içermeyen bir yöntemin Dispatcher temsilcisi.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yoksa.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentException

priorityInactiveeşittir.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

ArgumentNullException

method, null değeridir.

Örnekler

Aşağıdaki örnek, kullanarak Invokebir DispatcherNormal temsilcisini öğesine yerleştirir.

// 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

Açıklamalar

WPF'de, yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana ui iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin arka plan iş parçacığının ui iş parçacığıyla ilişkilendirilmiş çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumlu ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri arama döndürülene kadar denetim çağıran nesneye dönmez.

Invoke(Delegate, Object[])

Belirtilen temsilciyi, ilişkili olduğu iş parçacığında Dispatcher belirtilen bağımsız değişkenlerle zaman uyumlu olarak yürütür.

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

Parametreler

method

Delegate

içinde belirtilen argsve olay kuyruğuna gönderilen parametreleri alan bir yöntemin Dispatcher temsilcisi.

args

Object[]

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne dizisi. olabilir null.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yoksa.

Açıklamalar

WPF'de, yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana ui iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin arka plan iş parçacığının ui iş parçacığıyla ilişkilendirilmiş çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumlu ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri arama döndürülene kadar denetim çağıran nesneye dönmez.

Invoke(Action, DispatcherPriority)

Belirtilen Action işlemi, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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)

Parametreler

callback

Action

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

priority

DispatcherPriority

Belirtilen geri çağırmanın içindeki diğer bekleyen işlemlere Dispatchergöre çağrılma sırasını belirleyen öncelik.

Invoke(Action)

Belirtilen Action işlemi ilişkili iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

public:
 void Invoke(Action ^ callback);

public void Invoke (Action callback);

member this.Invoke : Action -> unit

Public Sub Invoke (callback As Action)

Parametreler

callback

Action

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

Açıklamalar

Varsayılan öncelik şeklindedir DispatcherPriority.Send.

Invoke(Delegate, DispatcherPriority, Object[])

Belirtilen temsilciyi belirtilen önceliğe göre ilişkili iş parçacığında Dispatcher belirtilen bağımsız değişkenlerle zaman uyumlu olarak yürütür.

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

Parametreler

method

Delegate

içinde belirtilen argsve olay kuyruğuna gönderilen parametreleri alan bir yöntemin Dispatcher temsilcisi.

priority

DispatcherPriority

Olay kuyruğundaki diğer bekleyen işlemlere göre belirtilen yöntemin Dispatcher çağrıldığı öncelik.

args

Object[]

Verilen yönteme bağımsız değişken olarak geçirecek bir nesne dizisi. olabilir null.

Döndürülenler

Object

Çağrılan temsilcinin dönüş değeri veya null temsilcinin dönüş değeri yoksa.

Açıklamalar

WPF'de, yalnızca bir DispatcherObject oluşturan iş parçacığı bu nesneye erişebilir. Örneğin, ana ui iş parçacığından ayrılan bir arka plan iş parçacığı, kullanıcı arabirimi iş parçacığında oluşturulan bir Button öğesinin içeriğini güncelleştiremez. Arka plan iş parçacığının öğesinin Content özelliğine erişebilmesi Buttoniçin arka plan iş parçacığının ui iş parçacığıyla ilişkilendirilmiş çalışma için Dispatcher temsilci seçmesi gerekir. Bu, veya BeginInvokekullanılarak Invoke gerçekleştirilir. Invoke zaman uyumlu ve BeginInvoke zaman uyumsuzdur. İşlem belirtilen DispatcherPrioritykonumundaki olay kuyruğuna Dispatcher eklenir.

Invoke zaman uyumlu bir işlemdir; bu nedenle, geri arama döndürülene kadar denetim çağıran nesneye dönmez.

Invoke<TResult>(Func<TResult>)

Belirtilen Func<TResult> işlemi ilişkili iş parçacığında Dispatcher zaman uyumlu olarak yürütür.

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

Tür Parametreleri

TResult

Belirtilen temsilcinin dönüş değeri türü.

Parametreler

callback

Func<TResult>

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

Döndürülenler

TResult

tarafından callbackdöndürülen değer.

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

Belirtilen Func<TResult> işlemi, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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

Tür Parametreleri

TResult

Belirtilen temsilcinin dönüş değeri türü.

Parametreler

callback

Func<TResult>

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

priority

DispatcherPriority

Belirtilen geri çağırmanın içindeki diğer bekleyen işlemlere Dispatchergöre çağrılma sırasını belirleyen öncelik.

Döndürülenler

TResult

tarafından callbackdöndürülen değer.

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

Belirtilen Func<TResult> işlemi, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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

Tür Parametreleri

TResult

Belirtilen temsilcinin dönüş değeri türü.

Parametreler

callback

Func<TResult>

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

priority

DispatcherPriority

Belirtilen geri çağırmanın içindeki diğer bekleyen işlemlere Dispatchergöre çağrılma sırasını belirleyen öncelik.

cancellationToken

CancellationToken

İşlemin iptal edilip edilmeyeceğini belirten bir nesne.

Döndürülenler

TResult

tarafından callbackdöndürülen değer.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

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

Belirtilen Func<TResult> işlemi, ilişkili olduğu iş parçacığında Dispatcher belirtilen önceliğe göre zaman uyumlu olarak yürütür.

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

Tür Parametreleri

TResult

Belirtilen temsilcinin dönüş değeri türü.

Parametreler

callback

Func<TResult>

Dağıtıcı aracılığıyla çağrılacak bir temsilci.

priority

DispatcherPriority

Belirtilen geri çağırmanın içindeki diğer bekleyen işlemlere Dispatchergöre çağrılma sırasını belirleyen öncelik.

cancellationToken

CancellationToken

İşlemin iptal edilip edilmeyeceğini belirten bir nesne.

timeout

TimeSpan

İşlemin başlatılmasını bekleme süresi üst sınırı. İşlem başlatıldıktan sonra, bu yöntem döndürülmeden önce tamamlanır. Sonsuz beklemeyi belirtmek için -1 değerini kullanın. Aynı iş parçacığı çağrısında, diğer tüm negatif değerler -1'e dönüştürülür ve bu da sonsuz beklemeyle sonuçlanır. bir çapraz iş parçacığı çağrısında, başka bir negatif değer bir ArgumentOutOfRangeExceptionoluşturur.

Döndürülenler

TResult

tarafından callbackdöndürülen değer.

Özel durumlar

ArgumentNullException

callback, null değeridir.

ArgumentOutOfRangeException

timeout -1 dışında bir negatif sayıdır ve yöntem iş parçacıkları arasında çağrıldı.

InvalidEnumArgumentException

priority geçerli bir öncelik değildir.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.