diff --git a/xml/System.Windows.Threading/Dispatcher.xml b/xml/System.Windows.Threading/Dispatcher.xml index f20009af6ee..da7a3ba8704 100644 --- a/xml/System.Windows.Threading/Dispatcher.xml +++ b/xml/System.Windows.Threading/Dispatcher.xml @@ -30,7 +30,7 @@ If a is shut down, it cannot be restarted. - In [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)], a can only be accessed by the it is associated with. For example, a background thread cannot update the contents of a that is associated with the on the [!INCLUDE[TLA2#tla_ui](~/includes/tla2sharptla-ui-md.md)] thread. In order for the background thread to access the property of the , the background thread must delegate the work to the associated with the [!INCLUDE[TLA2#tla_ui](~/includes/tla2sharptla-ui-md.md)] thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the queue of the at the specified . + In WPF, a can only be accessed by the it is associated with. For example, a background thread cannot update the contents of a that is associated with the on the [!INCLUDE[TLA2#tla_ui](~/includes/tla2sharptla-ui-md.md)] thread. In order for the background thread to access the property of the , the background thread must delegate the work to the associated with the [!INCLUDE[TLA2#tla_ui](~/includes/tla2sharptla-ui-md.md)] thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the queue of the at the specified . If is called on a that has shut down, the status property of the returned is set to . @@ -71,7 +71,7 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is asynchronous; therefore, control returns immediately to the calling object after it is called. @@ -148,7 +148,7 @@ is asynchronous; therefore, control returns immediately to the calling object after it is called. - In [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)], only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . If is called on a that has shut down, the status property of the returned is set to . @@ -189,7 +189,7 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. The delegate to a method that takes no arguments, which is pushed onto the event queue. Executes the specified delegate asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. @@ -213,7 +213,7 @@ is asynchronous; therefore, control returns immediately to the calling object after it is called. - In [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)], only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . If is called on a that has shut down, the status property of the returned is set to . @@ -276,7 +276,7 @@ The delegate to a method that takes parameters specified in , which is pushed onto the event queue. - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. An array of objects to pass as arguments to the given method. Can be . Executes the specified delegate asynchronously with the specified arguments, at the specified priority, on the thread that the was created on. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. @@ -296,7 +296,7 @@ is asynchronous; therefore, control returns immediately to the calling object after it is called. - In [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)], only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . If is called on a that has shut down, the status property of the returned is set to . @@ -338,7 +338,7 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. A delegate to a method that takes one argument, which is pushed onto the event queue. The object to pass as an argument to the specified method. Executes the specified delegate asynchronously at the specified priority and with the specified argument on the thread the is associated with. @@ -347,7 +347,7 @@ returns a object that can be used to interact with the delegate when the delegate is in the event queue. @@ -363,13 +363,11 @@ is asynchronous; therefore, control returns immediately to the calling object after it is called. - In [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)], only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . If multiple calls are made at the same , they will be executed in the order the calls were made. - If is called on a that has shut down, the status property of the returned is set to . - - + If is called on a that has shut down, the status property of the returned is set to . ## Examples The following example shows how to place an operation onto a . @@ -431,7 +429,7 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. A delegate to a method that takes multiple arguments, which is pushed onto the event queue. The object to pass as an argument to the specified method. An array of objects to pass as arguments to the specified method. @@ -457,7 +455,7 @@ is asynchronous; therefore, control returns immediately to the calling object after it is called. - In [!INCLUDE[TLA2#tla_winclient](~/includes/tla2sharptla-winclient-md.md)], only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . If multiple calls are made at the same , they will be executed in the order the calls were made. @@ -553,9 +551,7 @@ can be called from any thread. - The difference between and is returns a Boolean indicating whether the calling thread has access to the and throws an exception. - - + The difference between and is returns a Boolean indicating whether the calling thread has access to the and throws an exception. ## Examples The following example uses to determine whether a thread has access to a . The method on the associated with the is called to verify access to the thread. If the calling thread has access to the , the is updated by accessing the members of the ; otherwise, a delegate, which accepts a as an argument, is placed onto the . The will delegate the work of updating the . @@ -635,9 +631,7 @@ The structure that returns when it is called can be used to re-enable dispatcher processing. Calling on the structure re-enables processing. - can only be called on the thread the is associated with. - - + can only be called on the thread the is associated with. ## Examples The following example shows how to disable dispatcher processing and re-enable dispatcher processing. is called in a **using** statement. returns a structure that is used as the object to be disposed when the **using** block finishes. When is called on the structure, dispatcher processing is re-enabled. @@ -848,11 +842,9 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . - is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. - - + is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. ## Examples The following example places a delegate onto a at using . @@ -911,7 +903,7 @@ A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . Executes the specified synchronously at the specified priority on the thread the is associated with. To be added. @@ -952,7 +944,7 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. @@ -990,19 +982,17 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority with which the specified method is invoked, relative to the other pending operations in the event queue. A delegate to a method that takes no arguments, which is pushed onto the event queue. - Executes the specified delegate synchronously at the specified priority on the thread on which the is associated with. + Executes the specified delegate synchronously at the specified priority on the thread that the is associated with. The return value from the delegate being invoked or if the delegate has no return value. may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . - - is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . - + is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. ## Examples The following example places a delegate onto a at using . @@ -1043,7 +1033,7 @@ A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . An object that indicates whether to cancel the action. Executes the specified synchronously at the specified priority on the thread the is associated with. To be added. @@ -1084,20 +1074,24 @@ A delegate to a method that takes parameters specified in , which is pushed onto the event queue. - The maximum amount of time to wait for the operation to complete. - An array of objects to pass as arguments to the given method. Can be . + The maximum amount of time to wait for the operation to start. However, once the operation starts, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . + An array of objects to pass as arguments to the given method. Can be if no arguments are needed. Executes the specified delegate within the designated time span at the specified priority with the specified arguments synchronously on the thread the is associated with. The return value from the delegate being invoked or if the delegate has no return value. may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . - is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. + is a synchronous operation; therefore, control won't return to the calling object until after the callback returns. ]]> + + is . + + is a negative number other than -1, and you're invoking across threads. @@ -1130,7 +1124,7 @@ A delegate to a method that takes parameters specified in , which is pushed onto the event queue. - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority with which the specified method is invoked, relative to the other pending operations in the event queue. An array of objects to pass as arguments to the given method. Can be . Executes the specified delegate at the specified priority with the specified arguments synchronously on the thread the is associated with. The return value from the delegate being invoked or if the delegate has no return value. @@ -1138,7 +1132,7 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. @@ -1177,7 +1171,7 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. A delegate to a method that takes one argument, which is pushed onto the event queue. An object to pass as an argument to the given method. Executes the specified delegate at the specified priority with the specified argument synchronously on the thread the is associated with. @@ -1186,9 +1180,9 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. @@ -1236,8 +1230,8 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. - The maximum time to wait for the operation to finish. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. + The maximum amount of time to wait for the operation to start. Once the operation has started, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . The delegate to a method that takes no arguments, which is pushed onto the event queue. Executes the specified delegate synchronously at the specified priority and with the specified time-out value on the thread the was created. The return value from the delegate being invoked or if the delegate has no return value. @@ -1245,12 +1239,20 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. ]]> + + is . + + is a negative number other than -1, and this method was invoked across threads. + + is equal to . + + is not a valid priority. @@ -1281,12 +1283,18 @@ - A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + An Action delegate to invoke through the dispatcher. + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . An object that indicates whether to cancel the action. - The minimum amount of time to wait for the operation to start. + The maximum amount of time to wait for the operation to start. Once the operation has started, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . Executes the specified synchronously at the specified priority on the thread the is associated with. To be added. + + is . + + is a negative number other than -1, and this method was invoked across threads. + + is not a valid priority. @@ -1325,8 +1333,8 @@ A delegate to a method that takes parameters specified in , which is pushed onto the event queue. - The maximum amount of time to wait for the operation to complete. - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The maximum amount of time to wait for the operation to start. Once the operation has started, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. An array of objects to pass as arguments to the given method. Can be . Executes the specified delegate within the designated time span at the specified priority with the specified arguments synchronously on the thread the is associated with. The return value from the delegate being invoked or if the delegate has no return value. @@ -1334,12 +1342,20 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. ]]> + + is . + + is a negative number other than -1, and this method was invoked across threads. + + is equal to . + + is not a valid priority. @@ -1380,7 +1396,7 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. A delegate to a method that takes multiple arguments, which is pushed onto the event queue. An object to pass as an argument to the given method. An array of objects to pass as arguments to the given method. @@ -1390,9 +1406,9 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. @@ -1441,8 +1457,8 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. - The maximum time to wait for the operation to finish. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. + The maximum amount of time to wait for the operation to start. Once the operation has started, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . A delegate to a method that takes multiple arguments, which is pushed onto the event queue. An object to pass as an argument to the given method. This can be if no arguments are needed. Executes the specified delegate at the specified priority with the specified argument synchronously on the thread the is associated with. @@ -1451,9 +1467,9 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. @@ -1506,8 +1522,8 @@ - The priority, relative to the other pending operations in the event queue, the specified method is invoked. - The maximum time to wait for the operation to finish. + The priority, relative to the other pending operations in the event queue, with which the specified method is invoked. + The maximum amount of time to wait for the operation to start. Once the operation has started, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . A delegate to a method that takes multiple arguments, which is pushed onto the event queue. An object to pass as an argument to the specified method. An array of objects to pass as arguments to the specified method. @@ -1517,9 +1533,9 @@ may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . + In WPF, only the thread that created a may access that object. For example, a background thread that is spun off from the main UI thread cannot update the contents of a that was created on the UI thread. In order for the background thread to access the Content property of the , the background thread must delegate the work to the associated with the UI thread. This is accomplished by using either or . is synchronous and is asynchronous. The operation is added to the event queue of the at the specified . is a synchronous operation; therefore, control will not return to the calling object until after the callback returns. @@ -1531,6 +1547,8 @@ is not a valid . is . + + is a negative number other than -1, and this method was invoked across threads. @@ -1559,15 +1577,7 @@ The return value type of the specified delegate. A delegate to invoke through the dispatcher. Executes the specified synchronously on the thread the is associated with. - To be added. - - - + The value returned by . @@ -1596,17 +1606,9 @@ The return value type of the specified delegate. A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . Executes the specified synchronously at the specified priority on the thread the is associated with. - To be added. - - - + The value returned by . @@ -1636,18 +1638,10 @@ The return value type of the specified delegate. A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . An object that indicates whether to cancel the operation. Executes the specified synchronously at the specified priority on the thread the is associated with. - To be added. - - - + The value returned by . @@ -1683,19 +1677,17 @@ The return value type of the specified delegate. A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . An object that indicates whether to cancel the operation. - The minimum amount of time to wait for the operation to start. + The maximum amount of time to wait for the operation to start. Once the operation has started, it will complete before this method returns. To specify an infinite wait, use a value of -1. In a same-thread call, any other negative value is converted to -1, resulting in an infinite wait. In a cross-thread call, any other negative value throws an . Executes the specified synchronously at the specified priority on the thread the is associated with. - To be added. - - - + The value returned by . + + is . + + is a negative number other than -1, and the method was invoked across threads. + + is not a valid priority. @@ -1755,7 +1747,7 @@ A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . Executes the specified asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. To be added. @@ -1789,7 +1781,7 @@ A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . An object that indicates whether to cancel the action. Executes the specified asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. @@ -1852,7 +1844,7 @@ The return value type of the specified delegate. A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . Executes the specified asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. To be added. @@ -1890,7 +1882,7 @@ The return value type of the specified delegate. A delegate to invoke through the dispatcher. - The priority that determines in what order the specified callback is invoked relative to the other pending operations in the . + The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . An object that indicates whether to cancel the operation. Executes the specified asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. @@ -1978,9 +1970,7 @@ enters a loop represented by the parameter `frame`. At each iteration of the loop, the will check the property on the class to determine whether the loop should continue or if it should stop. - allows for the property to be set explicitly and it respects the property on the . This means when the starts to shut down, frames that use the default implementation will exit, which enables all nested frames to exit. - - + allows for the property to be set explicitly and it respects the property on the . This means when the starts to shut down, frames that use the default implementation will exit, which enables all nested frames to exit. ## Examples The following example shows how to use a to achieve similar results as the [!INCLUDE[TLA#tla_winforms](~/includes/tlasharptla-winforms-md.md)] method. @@ -2296,9 +2286,7 @@ This method is public; therefore, any thread can check to see whether it has access to the . - The difference between and is returns a Boolean if the calling thread does not have access to the and throws an exception. - - + The difference between and is returns a Boolean if the calling thread does not have access to the and throws an exception. ## Examples The following example uses to determine whether a thread has access to the thread that a was created on. The method takes an object as an argument, which is cast to a . The method on the of the is called to verify access to the thread.