Class AsyncResult
A lightweight net35
-compatible asynchronous operation (promise) for Unity3d
.
Implements
Inherited Members
Namespace: UnityFx.Async
Assembly: UnityFx.Async-netstandard2.0.dll
Syntax
public class AsyncResult : IAsyncOperation, IAsyncOperationCallbacks, IAsyncCancellable, IAsyncResult, IDisposable, IAsyncContinuation, IEnumerator
Remarks
This class is the core entity of the library. In many aspects it mimics Task
interface and behaviour.
For example, any AsyncResult instance can have any number of continuations (added either explicitly
via AddCompletionCallback
call or implicitly using async
/await
keywords). These continuations
can be invoked on a an arbitrary SynchronizationContext. The class can be used to implement Asynchronous
Programming Model (APM). There are operation state accessors that can be used exactly like corresponding properties of
Task
. While the class implements IDisposable disposing is only required if AsyncWaitHandle
property was used.
Constructors
| Improve this Doc View SourceAsyncResult()
Initializes a new instance of the AsyncResult class.
Declaration
public AsyncResult()
AsyncResult(AsyncCallback, Object)
Initializes a new instance of the AsyncResult class.
Declaration
public AsyncResult(AsyncCallback asyncCallback, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncCallback | asyncCallback | User-defined completion callback. |
| Object | asyncState | User-defined data returned by AsyncState. |
AsyncResult(AsyncCreationOptions)
Initializes a new instance of the AsyncResult class with the specified CreationOptions.
Declaration
public AsyncResult(AsyncCreationOptions options)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncCreationOptions | options | The AsyncCreationOptions used to customize the operation's behavior. |
AsyncResult(AsyncCreationOptions, AsyncCallback, Object)
Initializes a new instance of the AsyncResult class.
Declaration
public AsyncResult(AsyncCreationOptions options, AsyncCallback asyncCallback, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncCreationOptions | options | The AsyncCreationOptions used to customize the operation's behavior. |
| AsyncCallback | asyncCallback | User-defined completion callback. |
| Object | asyncState | User-defined data returned by AsyncState. |
AsyncResult(AsyncCreationOptions, Object)
Initializes a new instance of the AsyncResult class.
Declaration
public AsyncResult(AsyncCreationOptions options, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncCreationOptions | options | The AsyncCreationOptions used to customize the operation's behavior. |
| Object | asyncState | User-defined data returned by AsyncState. |
AsyncResult(AsyncOperationStatus)
Initializes a new instance of the AsyncResult class with the specified Status.
Declaration
public AsyncResult(AsyncOperationStatus status)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | Initial value of the Status property. |
AsyncResult(AsyncOperationStatus, AsyncCallback, Object)
Initializes a new instance of the AsyncResult class with the specified Status.
Declaration
public AsyncResult(AsyncOperationStatus status, AsyncCallback asyncCallback, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | Initial value of the Status property. |
| AsyncCallback | asyncCallback | User-defined completion callback. |
| Object | asyncState | User-defined data returned by AsyncState. |
AsyncResult(AsyncOperationStatus, Object)
Initializes a new instance of the AsyncResult class with the specified Status.
Declaration
public AsyncResult(AsyncOperationStatus status, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | Initial value of the Status property. |
| Object | asyncState | User-defined data returned by AsyncState. |
AsyncResult(AsyncOperationStatus, AsyncCreationOptions)
Initializes a new instance of the AsyncResult class with the specified Status and CreationOptions.
Declaration
public AsyncResult(AsyncOperationStatus status, AsyncCreationOptions options)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | Initial value of the Status property. |
| AsyncCreationOptions | options | The AsyncCreationOptions used to customize the operation's behavior. |
AsyncResult(AsyncOperationStatus, AsyncCreationOptions, AsyncCallback, Object)
Initializes a new instance of the AsyncResult class with the specified Status and CreationOptions.
Declaration
public AsyncResult(AsyncOperationStatus status, AsyncCreationOptions options, AsyncCallback asyncCallback, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | Initial value of the Status property. |
| AsyncCreationOptions | options | The AsyncCreationOptions used to customize the operation's behavior. |
| AsyncCallback | asyncCallback | User-defined completion callback. |
| Object | asyncState | User-defined data returned by AsyncState. |
AsyncResult(AsyncOperationStatus, AsyncCreationOptions, Object)
Initializes a new instance of the AsyncResult class with the specified Status and CreationOptions.
Declaration
public AsyncResult(AsyncOperationStatus status, AsyncCreationOptions options, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | Initial value of the Status property. |
| AsyncCreationOptions | options | The AsyncCreationOptions used to customize the operation's behavior. |
| Object | asyncState | User-defined data returned by AsyncState. |
Properties
| Improve this Doc View SourceAsyncState
Gets a user-defined object that qualifies or contains information about an asynchronous operation.
Declaration
public object AsyncState { get; }
Property Value
| Type | Description |
|---|---|
| Object | A user-defined object that qualifies or contains information about an asynchronous operation. |
AsyncWaitHandle
Gets a WaitHandle that is used to wait for an asynchronous operation to complete.
Declaration
public WaitHandle AsyncWaitHandle { get; }
Property Value
| Type | Description |
|---|---|
| WaitHandle | A WaitHandle that is used to wait for an asynchronous operation to complete. |
Remarks
The handle is lazily allocated on the first property access. Make sure to call Dispose() when the operation instance is not in use.
See Also
| Improve this Doc View SourceCanceledOperation
Gets an operation that's already been canceled.
Declaration
public static AsyncResult CanceledOperation { get; }
Property Value
| Type | Description |
|---|---|
| AsyncResult | Canceled IAsyncOperation instance. |
Remarks
Note that Dispose() call have no effect on operations returned with the property. May not always return the same instance.
CompletedOperation
Gets an operation that's already been completed successfully.
Declaration
public static AsyncResult CompletedOperation { get; }
Property Value
| Type | Description |
|---|---|
| AsyncResult | Completed IAsyncOperation instance. |
Remarks
Note that Dispose() call have no effect on operations returned with the property. May not always return the same instance.
CompletedSynchronously
Gets a value indicating whether the asynchronous operation completed synchronously.
Declaration
public bool CompletedSynchronously { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | true if the asynchronous operation completed synchronously; otherwise, false. |
Remarks
For the vast majority of cases this is false. Do not rely on this vlaue.
See Also
| Improve this Doc View SourceCreationOptions
Gets the AsyncCreationOptions used to create this operation.
Declaration
public AsyncCreationOptions CreationOptions { get; }
Property Value
| Type | Description |
|---|---|
| AsyncCreationOptions | The operation creation options. |
DefaultSynchronizationContext
Gets or sets a reference to SynchronizationContext that is used for majority of continuations.
Declaration
public static SynchronizationContext DefaultSynchronizationContext { get; set; }
Property Value
| Type | Description |
|---|---|
| SynchronizationContext | An instance of SynchronizationContext that is used as default one. Initial value is null. |
Remarks
This property is supposed to be used as allocation optimization in applications working mostly with single SynchronizationContext instance (such as Unity3d applications). Usually this should be set to a context attached to the app UI thread.
Exception
Gets an exception that caused the operation to end prematurely. If the operation completed successfully or has not yet thrown any exceptions, this will return null.
Declaration
public Exception Exception { get; }
Property Value
| Type | Description |
|---|---|
| Exception | An exception that caused the operation to end prematurely. |
FaultedOperation
Gets a faulted operation.
Declaration
public static AsyncResult FaultedOperation { get; }
Property Value
| Type | Description |
|---|---|
| AsyncResult | Faulted IAsyncOperation instance. |
Remarks
Note that Dispose() call have no effect on operations returned with the property. May not always return the same instance.
Id
Gets a unique ID for the operation instance.
Declaration
public int Id { get; }
Property Value
| Type | Description |
|---|---|
| Int32 | Unique non-zero identifier of the operation instance. |
IsCanceled
Gets a value indicating whether the operation completed due to being canceled (i.e. with Canceled status).
Declaration
public bool IsCanceled { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation was canceled. |
IsCancellationRequested
Gets a value indicating whether the operation cancellation was requested.
Declaration
protected bool IsCancellationRequested { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation cancellation was requested. |
IsCompleted
Gets a value indicating whether the asynchronous operation has completed.
Declaration
public bool IsCompleted { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | true if the operation is complete; otherwise, false. |
See Also
| Improve this Doc View SourceIsCompletedSuccessfully
Gets a value indicating whether the operation completed successfully (i.e. with RanToCompletion status).
Declaration
public bool IsCompletedSuccessfully { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation completed successfully. |
IsDisposed
Gets a value indicating whether the operation instance is disposed.
Declaration
protected bool IsDisposed { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation is disposed. |
IsFaulted
Gets a value indicating whether the operation completed due to an unhandled exception (i.e. with Faulted status).
Declaration
public bool IsFaulted { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation has failed. |
IsRunning
Gets a value indicating whether the operation in running.
Declaration
public bool IsRunning { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation is running. |
IsStarted
Gets a value indicating whether the operation has been started.
Declaration
public bool IsStarted { get; }
Property Value
| Type | Description |
|---|---|
| Boolean | A value indicating whether the operation has been started. |
Progress
Gets the operation progress in range [0, 1].
Declaration
public float Progress { get; }
Property Value
| Type | Description |
|---|---|
| Single | Progress of the operation in range [0, 1]. |
Status
Gets the operation status identifier.
Declaration
public AsyncOperationStatus Status { get; }
Property Value
| Type | Description |
|---|---|
| AsyncOperationStatus | Identifier of the operation status. |
Methods
| Improve this Doc View SourceAddCompletionCallback(Object, SynchronizationContext)
Adds a completion callback to be executed after the operation has completed. If the operation is completed action
is invoked
on the syncContext
specified.
Declaration
public void AddCompletionCallback(object action, SynchronizationContext syncContext)
Parameters
| Type | Name | Description |
|---|---|---|
| Object | action | The callback to be executed when the operation has completed. Can be one of Action, System.Action<T> (with IAsyncOperation argument type), AsyncCallback, IAsyncContinuation or AsyncCompletedEventHandler. |
| SynchronizationContext | syncContext | If not null method attempts to marshal the continuation to the synchronization context. Otherwise the callback is invoked on a thread that initiated the operation completion. |
Remarks
The action
is invoked on a SynchronizationContext specified. Throwing an exception from the callback might cause unspecified behaviour.
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ObjectDisposedException | Thrown is the operation has been disposed. |
See Also
| Improve this Doc View SourceAddProgressCallback(Object, SynchronizationContext)
Adds a callback to be executed when the operation progress has changed. If the operation is completed action
is invoked
on the syncContext
specified.
Declaration
public void AddProgressCallback(object action, SynchronizationContext syncContext)
Parameters
| Type | Name | Description |
|---|---|---|
| Object | action | The callback to be executed when the operation progress has changed. |
| SynchronizationContext | syncContext | If not null method attempts to marshal the continuation to the synchronization context. Otherwise the callback is invoked on a thread that initiated the operation. |
Remarks
The action
is invoked on a SynchronizationContext specified. Throwing an exception from the callback might cause unspecified behaviour.
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ObjectDisposedException | Thrown is the operation has been disposed. |
See Also
| Improve this Doc View SourceCancel()
Initiates cancellation of an asynchronous operation.
Declaration
public void Cancel()
Remarks
There is no guarantee that this call will actually cancel the operation or that the operation will be cancelled immidiately. SuppressCancellation can be used to suppress this method for a specific operation instance.
Delay(Int32)
Creates an operation that completes after a time delay.
Declaration
public static AsyncResult Delay(int millisecondsDelay)
Parameters
| Type | Name | Description |
|---|---|---|
| Int32 | millisecondsDelay | The number of milliseconds to wait before completing the returned operation, or Infinite (-1) to wait indefinitely. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the time delay. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentOutOfRangeException | Thrown if the |
See Also
| Improve this Doc View SourceDelay(Int32, IAsyncUpdateSource)
Creates an operation that completes after a time delay. This method creates a more effecient operation than Delay(Int32) but requires a specialized update source.
Declaration
public static AsyncResult Delay(int millisecondsDelay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| Int32 | millisecondsDelay | The number of milliseconds to wait before completing the returned operation, or Infinite (-1) to wait indefinitely. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the time delay. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentOutOfRangeException | Thrown if the |
See Also
| Improve this Doc View SourceDelay(Single)
Creates an operation that completes after a specified time interval.
Declaration
public static AsyncResult Delay(float secondsDelay)
Parameters
| Type | Name | Description |
|---|---|---|
| Single | secondsDelay | The number of seconds to wait before completing the returned operation, or Infinite (-1) to wait indefinitely. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the time delay. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentOutOfRangeException | Thrown if the |
See Also
| Improve this Doc View SourceDelay(Single, IAsyncUpdateSource)
Creates an operation that completes after a specified time interval. This method creates a more effecient operation than Delay(Single) but requires a specialized update source.
Declaration
public static AsyncResult Delay(float secondsDelay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| Single | secondsDelay | The number of seconds to wait before completing the returned operation, or Infinite (-1) to wait indefinitely. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the time delay. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentOutOfRangeException | Thrown if the |
See Also
| Improve this Doc View SourceDelay(TimeSpan)
Creates an operation that completes after a specified time interval.
Declaration
public static AsyncResult Delay(TimeSpan delay)
Parameters
| Type | Name | Description |
|---|---|---|
| TimeSpan | delay | The time span to wait before completing the returned operation, or |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the time delay. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentOutOfRangeException | Thrown if the |
See Also
| Improve this Doc View SourceDelay(TimeSpan, IAsyncUpdateSource)
Creates an operation that completes after a specified time interval. This method creates a more effecient operation than Delay(TimeSpan) but requires a specialized update source.
Declaration
public static AsyncResult Delay(TimeSpan delay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| TimeSpan | delay | The time span to wait before completing the returned operation, or |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the time delay. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentOutOfRangeException | Thrown if the |
See Also
| Improve this Doc View SourceDispose()
Disposes the AsyncResult, releasing all of its unmanaged resources. This call is only required if AsyncWaitHandle was accessed; otherwise it is safe to ignore this method.
Declaration
public void Dispose()
Remarks
Unlike most of the members of AsyncResult, this method is not thread-safe. Also, Dispose() may only be called on an AsyncResult that is in one of the final states: RanToCompletion, Faulted or Canceled.
Exceptions
| Type | Condition |
|---|---|
| InvalidOperationException | Thrown if the operation is not completed. |
See Also
| Improve this Doc View SourceDispose(Boolean)
Releases unmanaged resources used by the object.
Declaration
protected virtual void Dispose(bool disposing)
Parameters
| Type | Name | Description |
|---|---|---|
| Boolean | disposing | A langword_csharp_bool value that indicates whether this method is being called due to a call to Dispose(). |
Remarks
Unlike most of the members of AsyncResult, this method is not thread-safe. Do not throw exceptions in Dispose(Boolean).
See Also
| Improve this Doc View SourceFromAction(Action)
Creates a completed IAsyncOperation that represents result of the action
specified.
Declaration
public static AsyncResult FromAction(Action action)
Parameters
| Type | Name | Description |
|---|---|---|
| Action | action | The delegate to execute. |
Returns
| Type | Description |
|---|---|
| AsyncResult | A completed operation that represents |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
FromAction(Action, CancellationToken)
Creates a completed IAsyncOperation that represents result of the action
specified.
Declaration
public static AsyncResult FromAction(Action action, CancellationToken cancellationToken)
Parameters
| Type | Name | Description |
|---|---|---|
| Action | action | The delegate to execute. |
| CancellationToken | cancellationToken | A cancellation token to check before executing the |
Returns
| Type | Description |
|---|---|
| AsyncResult | A completed operation that represents |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromAction(Delegate, Object[])
Creates a completed IAsyncOperation that represents result of the callback
specified.
Declaration
public static AsyncResult<object> FromAction(Delegate callback, object[] args)
Parameters
| Type | Name | Description |
|---|---|---|
| Delegate | callback | The delegate to execute. |
| Object[] | args | Arguments of the |
Returns
| Type | Description |
|---|---|
| AsyncResult<Object> | A completed operation that represents the |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromAction(SendOrPostCallback, Object)
Creates a completed IAsyncOperation that represents result of the callback
specified.
Declaration
public static AsyncResult FromAction(SendOrPostCallback callback, object state)
Parameters
| Type | Name | Description |
|---|---|---|
| SendOrPostCallback | callback | The delegate to execute. |
| Object | state | User-defained state to pass to the |
Returns
| Type | Description |
|---|---|
| AsyncResult | A completed operation that represents |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromAction<T>(Action<T>, T)
Creates a completed IAsyncOperation that represents result of the action
specified.
Declaration
public static AsyncResult FromAction<T>(Action<T> action, T state)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Action<T> | action | The delegate to execute. |
| T | state | User-defained state to pass to the |
Returns
| Type | Description |
|---|---|
| AsyncResult | A completed operation that represents |
Type Parameters
| Name | Description |
|---|---|
| T |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromAction<TResult>(Func<TResult>)
Creates a completed IAsyncOperation<TResult> that represents result of the action
specified.
Declaration
public static AsyncResult<TResult> FromAction<TResult>(Func<TResult> action)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<TResult> | action | The delegate to execute. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | A completed operation that represents |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromAction<TResult>(Func<TResult>, CancellationToken)
Creates a completed IAsyncOperation<TResult> that represents result of the action
specified.
Declaration
public static AsyncResult<TResult> FromAction<TResult>(Func<TResult> action, CancellationToken cancellationToken)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<TResult> | action | The delegate to execute. |
| CancellationToken | cancellationToken | A cancellation token to check before executing the |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | A completed operation that represents |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromAction<T, TResult>(Func<T, TResult>, T)
Creates a completed IAsyncOperation that represents result of the action
specified.
Declaration
public static AsyncResult<TResult> FromAction<T, TResult>(Func<T, TResult> action, T state)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<T, TResult> | action | The delegate to execute. |
| T | state | User-defained state to pass to the |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | A completed operation that represents |
Type Parameters
| Name | Description |
|---|---|
| T | |
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromCanceled()
Creates a IAsyncOperation that is canceled.
Declaration
public static AsyncResult FromCanceled()
Returns
| Type | Description |
|---|---|
| AsyncResult | A canceled operation. |
See Also
| Improve this Doc View SourceFromCanceled(Object)
Creates a IAsyncOperation that is canceled.
Declaration
public static AsyncResult FromCanceled(object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult | A canceled operation. |
See Also
| Improve this Doc View SourceFromCanceled<T>()
Creates a IAsyncOperation<TResult> that is canceled.
Declaration
public static AsyncResult<T> FromCanceled<T>()
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A canceled operation. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromCanceled<T>(Object)
Creates a IAsyncOperation<TResult> that is canceled.
Declaration
public static AsyncResult<T> FromCanceled<T>(object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A canceled operation. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromException(Exception)
Creates a IAsyncOperation that has completed with a specified exception.
Declaration
public static AsyncResult FromException(Exception exception)
Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception | The exception to complete the operation with. |
Returns
| Type | Description |
|---|---|
| AsyncResult | A faulted operation. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
| Improve this Doc View SourceFromException(Exception, Object)
Creates a IAsyncOperation that has completed with a specified exception.
Declaration
public static AsyncResult FromException(Exception exception, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception | The exception to complete the operation with. |
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult | A faulted operation. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
See Also
FromException(String)
Creates a IAsyncOperation that has completed with the specified error message.
Declaration
public static AsyncResult FromException(string message)
Parameters
| Type | Name | Description |
|---|---|---|
| String | message | An exception message. |
Returns
| Type | Description |
|---|---|
| AsyncResult | A faulted operation. |
See Also
| Improve this Doc View SourceFromException(String, Object)
Creates a IAsyncOperation that has completed with a specified error message.
Declaration
public static AsyncResult FromException(string message, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| String | message | An exception message. |
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult | A faulted operation. |
See Also
| Improve this Doc View SourceFromException<T>(Exception)
Creates a IAsyncOperation<TResult> that has completed with a specified exception.
Declaration
public static AsyncResult<T> FromException<T>(Exception exception)
Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception | The exception to complete the operation with. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A faulted operation. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromException<T>(Exception, Object)
Creates a IAsyncOperation<TResult> that has completed with a specified exception.
Declaration
public static AsyncResult<T> FromException<T>(Exception exception, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception | The exception to complete the operation with. |
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A faulted operation. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
FromException<T>(String)
Creates a IAsyncOperation<TResult> that has completed with a specified error message.
Declaration
public static AsyncResult<T> FromException<T>(string message)
Parameters
| Type | Name | Description |
|---|---|---|
| String | message | An exception message. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A faulted operation. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromException<T>(String, Object)
Creates a IAsyncOperation<TResult> that has completed with a specified error message.
Declaration
public static AsyncResult<T> FromException<T>(string message, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| String | message | An exception message. |
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A faulted operation. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromObservable<T>(IObservable<T>)
Creates a IAsyncOperation<TResult> instance that can be used to track the source observable.
Declaration
public static AsyncResult<T> FromObservable<T>(IObservable<T> observable)
Parameters
| Type | Name | Description |
|---|---|---|
| System.IObservable<T> | observable | The source observable. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | Returns an IAsyncOperation<TResult> instance that can be used to track the observable. |
Type Parameters
| Name | Description |
|---|---|
| T | Type of the operation result. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
FromResult<T>(T)
Creates a IAsyncOperation<TResult> that has completed with a specified result.
Declaration
public static AsyncResult<T> FromResult<T>(T result)
Parameters
| Type | Name | Description |
|---|---|---|
| T | result | The result value with which to complete the operation. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A completed operation with the specified result value. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromResult<T>(T, Object)
Creates a IAsyncOperation<TResult> that has completed with a specified result.
Declaration
public static AsyncResult<T> FromResult<T>(T result, object asyncState)
Parameters
| Type | Name | Description |
|---|---|---|
| T | result | The result value with which to complete the operation. |
| Object | asyncState | User-defined data returned by AsyncState. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | A completed operation with the specified result value. |
Type Parameters
| Name | Description |
|---|---|
| T |
See Also
| Improve this Doc View SourceFromTask(Task)
Creates an IAsyncOperation instance that completes when the specified task
completes.
Declaration
public static AsyncResult FromTask(Task task)
Parameters
| Type | Name | Description |
|---|---|---|
| Task | task | The source Task instance. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An IAsyncOperation that represents the source |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
See Also
| Improve this Doc View SourceFromTask<T>(Task<T>)
Creates an IAsyncOperation<TResult> instance that completes when the specified task
completes.
Declaration
public static AsyncResult<T> FromTask<T>(Task<T> task)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Threading.Tasks.Task<T> | task | The source System.Threading.Tasks.Task<TResult> instance. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | An IAsyncOperation that represents the source |
Type Parameters
| Name | Description |
|---|---|
| T |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
See Also
| Improve this Doc View SourceGetNewId()
Gets a unique ID for an AsyncResult instance.
Declaration
public static int GetNewId()
Returns
| Type | Description |
|---|---|
| Int32 |
Remarks
This method should be used by all IAsyncOperation implementation for generating value of the Id property.
GetProgress()
Called when the progress is requested. Default implementation returns 0.
Declaration
protected virtual float GetProgress()
Returns
| Type | Description |
|---|---|
| Single |
Remarks
Make sure that each method call returns a value greater or equal to the previous. It is important for progress reporting consistency.
See Also
| Improve this Doc View SourceInvoke(IAsyncOperation)
Invokes the operation-specific continuation logic. Default implementation attempts to run the operation is op
has succeeded;
otherwise the operation transitions to failed state.
Declaration
public virtual void Invoke(IAsyncOperation op)
Parameters
| Type | Name | Description |
|---|---|---|
| IAsyncOperation | op | The completed antecedent operation. |
OnCancel()
Called when the operation cancellation has been requested. Default implementation does nothing.
Declaration
protected virtual void OnCancel()
See Also
| Improve this Doc View SourceOnCompleted()
Called when the operation is completed. Default implementation does nothing.
Declaration
protected virtual void OnCompleted()
Remarks
Throwing an exception in this method results in unspecified behaviour.
See Also
OnProgressChanged()
Called when the progress value has changed. Default implementation does nothing.
Declaration
protected virtual void OnProgressChanged()
Remarks
Throwing an exception in this method results in unspecified behaviour.
See Also
| Improve this Doc View SourceOnStarted()
Called when the operation is started (Status is set to Running). Default implementation does nothing.
Declaration
protected virtual void OnStarted()
See Also
| Improve this Doc View SourceOnStatusChanged(AsyncOperationStatus)
Called when the operation state has changed. Default implementation does nothing.
Declaration
protected virtual void OnStatusChanged(AsyncOperationStatus status)
Parameters
| Type | Name | Description |
|---|---|---|
| AsyncOperationStatus | status | The new status value. |
Remarks
Throwing an exception in this method results in unspecified behaviour.
See Also
RemoveCallback(Object)
Removes an existing completion/progress callback.
Declaration
public bool RemoveCallback(object action)
Parameters
| Type | Name | Description |
|---|---|---|
| Object | action | The callback to remove. Can be null. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if |
See Also
Retry(Func<IAsyncOperation>, Int32)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, int millisecondsRetryDelay)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, Int32, Int32)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, int millisecondsRetryDelay, int maxRetryCount)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, Int32, Int32, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, int millisecondsRetryDelay, int maxRetryCount, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, Int32, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, int millisecondsRetryDelay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, TimeSpan)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, TimeSpan retryDelay)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, TimeSpan, Int32)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, TimeSpan retryDelay, int maxRetryCount)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, TimeSpan, Int32, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, TimeSpan retryDelay, int maxRetryCount, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry(Func<IAsyncOperation>, TimeSpan, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult Retry(Func<IAsyncOperation> opFactory, TimeSpan retryDelay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the retry process. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, Int32)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, int millisecondsRetryDelay)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, Int32, Int32)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, int millisecondsRetryDelay, int maxRetryCount)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, Int32, Int32, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, int millisecondsRetryDelay, int maxRetryCount, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, Int32, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, int millisecondsRetryDelay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| Int32 | millisecondsRetryDelay | The number of milliseconds to wait after a failed try before starting a new operation. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, TimeSpan)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, TimeSpan retryDelay)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, TimeSpan, Int32)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, TimeSpan retryDelay, int maxRetryCount)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, TimeSpan, Int32, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully or maximum number of retries exceeded.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, TimeSpan retryDelay, int maxRetryCount, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
| Int32 | maxRetryCount | Maximum number of retries. Zero means no limits. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceRetry<TResult>(Func<IAsyncOperation<TResult>>, TimeSpan, IAsyncUpdateSource)
Creates an operation that completes when the source operation is completed successfully.
Declaration
public static AsyncResult<TResult> Retry<TResult>(Func<IAsyncOperation<TResult>> opFactory, TimeSpan retryDelay, IAsyncUpdateSource updateSource)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Func<IAsyncOperation<TResult>> | opFactory | A delegate that initiates the source operation. |
| TimeSpan | retryDelay | The time to wait after a failed try before starting a new operation. |
| IAsyncUpdateSource | updateSource | Update notifications provider. |
Returns
| Type | Description |
|---|---|
| AsyncResult<TResult> | An operation that represents the retry process. |
Type Parameters
| Name | Description |
|---|---|
| TResult |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the |
| ArgumentOutOfRangeException | Thrown if |
See Also
| Improve this Doc View SourceStart()
Transitions the operation into the Running state.
Declaration
public void Start()
Remarks
An operation may be started on once. Any attempts to schedule it a second time will result in an exception.
The Start() is used to execute an operation that has been created by calling one of the constructors. Typically, you do this when you need to separate the operation's creation from its execution, such as when you conditionally execute operations that you've created.
Exceptions
| Type | Condition |
|---|---|
| InvalidOperationException | Thrown if the transition has failed. |
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceThrowIfDisposed()
Throws ObjectDisposedException if this operation has been disposed.
Declaration
protected void ThrowIfDisposed()
ThrowIfNonSuccess()
Throws exception if the operation has failed or canceled.
Declaration
protected void ThrowIfNonSuccess()
TryReportProgress()
Reports changes in operation progress value.
Declaration
protected bool TryReportProgress()
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
TrySetCanceled()
Attempts to transition the operation into the Canceled state.
Declaration
protected bool TrySetCanceled()
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetCanceled(Boolean)
Attempts to transition the operation into the Canceled state.
Declaration
protected bool TrySetCanceled(bool completedSynchronously)
Parameters
| Type | Name | Description |
|---|---|---|
| Boolean | completedSynchronously | Value of the CompletedSynchronously property. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetCompleted()
Attempts to transition the operation into the RanToCompletion state.
Declaration
protected bool TrySetCompleted()
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetCompleted(Boolean)
Attempts to transition the operation into the RanToCompletion state.
Declaration
protected bool TrySetCompleted(bool completedSynchronously)
Parameters
| Type | Name | Description |
|---|---|---|
| Boolean | completedSynchronously | Value of the CompletedSynchronously property. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetException(Exception)
Attempts to transition the operation into the Faulted (or Canceled if the exception is OperationCanceledException) state.
Declaration
protected bool TrySetException(Exception exception)
Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception | An exception that caused the operation to end prematurely. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetException(Exception, Boolean)
Attempts to transition the operation into the Faulted (or Canceled if the exception is OperationCanceledException) state.
Declaration
protected bool TrySetException(Exception exception, bool completedSynchronously)
Parameters
| Type | Name | Description |
|---|---|---|
| Exception | exception | An exception that caused the operation to end prematurely. |
| Boolean | completedSynchronously | Value of the CompletedSynchronously property. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetException(String)
Attempts to transition the operation into the Faulted. The method calls TrySetException(Exception)
passing a new Exception instance with the specified message
.
Declaration
protected bool TrySetException(string message)
Parameters
| Type | Name | Description |
|---|---|---|
| String | message | An exception message. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetException(String, Boolean)
Attempts to transition the operation into the Faulted. The method calls TrySetException(Exception, Boolean)
passing a new Exception instance with the specified message
.
Declaration
protected bool TrySetException(string message, bool completedSynchronously)
Parameters
| Type | Name | Description |
|---|---|---|
| String | message | An exception message. |
| Boolean | completedSynchronously | Value of the CompletedSynchronously property. |
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the attemp was successfull; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetRunning()
Attempts to transition the operation into the Running state.
Declaration
protected bool TrySetRunning()
Returns
| Type | Description |
|---|---|
| Boolean |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTrySetScheduled()
Attempts to transition the operation into the Scheduled state.
Declaration
protected bool TrySetScheduled()
Returns
| Type | Description |
|---|---|
| Boolean |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceTryStart()
Attempts to transitions the operation into the Running state.
Declaration
public bool TryStart()
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the operation status was changed to Running; false otherwise. |
Exceptions
| Type | Condition |
|---|---|
| ObjectDisposedException | Thrown is the operation is disposed. |
See Also
| Improve this Doc View SourceWhenAll(IEnumerable<IAsyncOperation>)
Creates an operation that will complete when all of the specified objects in an enumerable collection have completed.
Declaration
public static AsyncResult WhenAll(IEnumerable<IAsyncOperation> ops)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Collections.Generic.IEnumerable<IAsyncOperation> | ops | The operations to wait on for completion. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the completion of all of the supplied operations. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentException | Thrown if the |
See Also
| Improve this Doc View SourceWhenAll(IAsyncOperation[])
Creates an operation that will complete when all of the specified objects in an array have completed.
Declaration
public static AsyncResult WhenAll(params IAsyncOperation[] ops)
Parameters
| Type | Name | Description |
|---|---|---|
| IAsyncOperation[] | ops | The operations to wait on for completion. |
Returns
| Type | Description |
|---|---|
| AsyncResult | An operation that represents the completion of all of the supplied operations. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentException | Thrown if the |
See Also
| Improve this Doc View SourceWhenAll<T>(IEnumerable<IAsyncOperation<T>>)
Creates an operation that will complete when all of the specified objects in an enumerable collection have completed.
Declaration
public static AsyncResult<T[]> WhenAll<T>(IEnumerable<IAsyncOperation<T>> ops)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Collections.Generic.IEnumerable<IAsyncOperation<T>> | ops | The operations to wait on for completion. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T[]> | An operation that represents the completion of all of the supplied operations. |
Type Parameters
| Name | Description |
|---|---|
| T |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentException | Thrown if the |
See Also
| Improve this Doc View SourceWhenAll<T>(IAsyncOperation<T>[])
Creates an operation that will complete when all of the specified objects in an array have completed.
Declaration
public static AsyncResult<T[]> WhenAll<T>(params IAsyncOperation<T>[] ops)
Parameters
| Type | Name | Description |
|---|---|---|
| IAsyncOperation<T>[] | ops | The operations to wait on for completion. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T[]> | An operation that represents the completion of all of the supplied operations. |
Type Parameters
| Name | Description |
|---|---|
| T |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentException | Thrown if the |
See Also
| Improve this Doc View SourceWhenAny<T>(T[])
Creates an operation that will complete when any of the specified objects in an array have completed.
Declaration
public static AsyncResult<T> WhenAny<T>(params T[] ops)where T : IAsyncOperation
Parameters
| Type | Name | Description |
|---|---|---|
| T[] | ops | The operations to wait on for completion. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | An operation that represents the completion of any of the supplied operations. |
Type Parameters
| Name | Description |
|---|---|
| T |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentException | Thrown if the |
See Also
| Improve this Doc View SourceWhenAny<T>(IEnumerable<T>)
Creates an operation that will complete when any of the specified objects in an enumerable collection have completed.
Declaration
public static AsyncResult<T> WhenAny<T>(IEnumerable<T> ops)where T : IAsyncOperation
Parameters
| Type | Name | Description |
|---|---|---|
| System.Collections.Generic.IEnumerable<T> | ops | The operations to wait on for completion. |
Returns
| Type | Description |
|---|---|
| AsyncResult<T> | An operation that represents the completion of any of the supplied operations. |
Type Parameters
| Name | Description |
|---|---|
| T |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if |
| ArgumentException | Thrown if the |
See Also
| Improve this Doc View SourceYield()
Creates an awaitable that asynchronously yields back to the current context when awaited (works the same as Yield()).
Declaration
public static YieldAwaitable Yield()
Returns
| Type | Description |
|---|---|
| YieldAwaitable | A context that, when awaited, will asynchronously transition back into the current context at the time of the await. If the current SynchronizationContext is non-null, that is treated as the current context. Otherwise, the continuation is executed on the ThreadPool. |
Events
| Improve this Doc View SourceCompleted
Raised when the operation is completed.
Declaration
public event AsyncCompletedEventHandler Completed
Event Type
| Type | Description |
|---|---|
| AsyncCompletedEventHandler |
Remarks
The event handler is invoked on a thread that registered it (if it has a SynchronizationContext attached). If the operation is already completed the event handler is called synchronously. Throwing an exception from the event handler might cause unspecified behaviour.
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the delegate being registered is null. |
| ObjectDisposedException | Thrown is the operation has been disposed. |
See Also
| Improve this Doc View SourceProgressChanged
Raised when the operation progress is changed.
Declaration
public event ProgressChangedEventHandler ProgressChanged
Event Type
| Type | Description |
|---|---|
| ProgressChangedEventHandler |
Remarks
The event handler is invoked on a thread that registered it (if it has a SynchronizationContext attached). If the operation is already completed the event handler is called synchronously. Throwing an exception from the event handler might cause unspecified behaviour.
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown if the delegate being registered is null. |
| ObjectDisposedException | Thrown is the operation has been disposed. |
See Also
Explicit Interface Implementations
| Improve this Doc View SourceIEnumerator.Current
Gets the current element in the collection.
Declaration
object IEnumerator.Current { get; }
Returns
| Type | Description |
|---|---|
| Object | The current element in the collection. |
Remarks
Not implemented. Always returns null.
IEnumerator.MoveNext()
Advances the enumerator to the next element of the collection.
Declaration
bool IEnumerator.MoveNext()
Returns
| Type | Description |
|---|---|
| Boolean | Returns true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection. |
Remarks
Checks whether the operation is completed. Returns false if it is; otherwise, true.
IEnumerator.Reset()
Sets the enumerator to its initial position, which is before the first element in the collection.
Declaration
void IEnumerator.Reset()
Remarks
Not implemented. Always throws NotSupportedException.


Italy extend perfect record with 3-0 rout of Bosnia
Italy stretched their perfect record in Euro 2020 qualifying to nine wins after goals from Francesco Acerbi, Lorenzo Insigne and Andrea Belotti gave them a 3-0 victory at Bosnia and Herzegovina in a lop-sided Group J qualifier on Friday.
ZENICA, Bosnia and Herzegovina: Italy stretched their perfect record in Euro 2020 qualifying to nine wins after goals from Francesco Acerbi, Lorenzo Insigne and Andrea Belotti gave them a 3-0 victory at Bosnia and Herzegovina in a lop-sided Group J qualifier on Friday.
The Italians, who were already assured of advancing, top the group with a maximum 27 points and were joined by second-placed Finland (18 points) who reached their first major tournament with a 3-0 home win over Lichtenstein in the early kickoff.
Bosnia dropped to fifth on 10 points and although Finland's victory dashed any slim hopes they had of finishing in the top two, the Balkan country can still progress to next year's tournament via the Nations League playoffs in March.
With Finland's success reducing the game to a dead rubber, it was played at walking pace for long spells but the gulf in class was apparent as defender Acerbi fired the visitors ahead with a fine individual effort in the 21st minute.
Insigne doubled Italy's lead with a bouncing shot on the turn in the 37th, while goalkeeper Gianluigi Donnarumma denied Bosnia's Ermin Bicakcic and Adnan Kovacevic with a pair of excellent saves at the other end.
Disgruntled home fans treated Belotti to a standing ovation after the striker made it 3-0 with a spectacular 53rd-minute goal, as he took a through ball in his stride and beat Ibrahim Sehic with a thunderbolt from 18 metres.
(Writing by Zoran Milosavljevic; Editing by Pritha Sarkar)


For other sources of game records, see the list in the links section.
On this page, you can download game records of top amateur games played on the K Go Server (KGS, formerly known as the Kiseido Go Server). I am grateful to Bill Shubert, who created KGS, for the permission to use these files, and for making them available to me in an easy way.
The games in the archives below are those where either one of the players (or both) is 7d or stronger, or both are 6d. All comments are stripped from these games, and all games with variations are omitted. They are suitable for use with Kombilo.
Need still more games? Have a look at the KGS games played by 4d+ players.
There are several versions of each archive, compressed in different ways: a .tar.gz, .tar.bz2, and .zip version; please choose the one which is most suitable for you. The content of the uncompressed archives is completely identical.
| Source | Time period | Number of games | Archive format | File size | Link |
| KGS | 2018_11 | 1879 | .zip | 1.6 MB | Download |


Maggie Hansford
For Brentsville Virginia Board of County Supervisors
Sign up for updates using the form below!


{% extends 'hxldash/info.html' %} {% load staticfiles %} {% block info %}
HXLdash is capable of two possible maps type. Point data and area data. This tutorial will guide you through how to create an area map (choropleth maps).
A. column with pcodes
B. The pcodes should be for a country supported by HXLDash
C. A column with values in it
Area map or choropleth maps only work for the countries HXLDash currently supports.
The full list of supported countries.
If the country you want is not on the list send us a message and we will try to get in up in a couple of days.
For those not familiar with place codes or pcodes, they are codes given to geographic administrative boundaries in countries by the responding humanitarian organisations. The purpose is to easily identify places in data sets to overcome two problem. That the same place can be spelt differently or different places can have the same name.
Pcodes generally have a format like
More details about pcodes can be found on the humanitarian response website.
Once you are using the pcodes for you country make sure you use the correct HXL tags. The tags that will trigger a choropleth map:
#country+code, #adm1+code, #adm2+code, #adm3+code
The final ingredient is needing a column with values so the colour of each area can be calculated. The following value columns are supported for maps.
#value, #affected, #population, #reached, #targeted, #inneed, #indicator+value, #capacity'
For this tutorial we will use a dataset on Ebola cases in Sierra Leone.
Grab the URL of the google spreadsheet and drop it into the load dashboard data input. The dataset has the three key ingredients. A. Sierra Leone is supported by HXLDash, B. We have #adm2 pcodes and C. We have a column wih values and the #affected tag.
The data set is automatically processed and shows the number of charts and maps generated
The next section allows you to pick a layout. For this tutorial we will choose a single large box for the map. This layout is in the bottom left.
And lastly you can pick a colour of your choice. In this case for now we will use the default red.
On the layout click the plus icon to get the chart and map selector. Click the maps tab and then select the map labeled "Map of cases by district code".
This will auto generate the map with suitable legend and title. To make this map online so you can share click save and complete the optional meta data fields. The map is now ready to share.


US telecom regulator approves T-Mobile and Sprint merger
WASHINGTON: The US telecom regulator on Tuesday (Nov 5) approved the merger of T-Mobile and Sprint, moving the tie-up of the third- and fourth-largest US carriers closer to completion.
The Federal Communications Commission cleared the US$26 billion deal three months after approval by antitrust officials at the US Justice Department.
The 3-2 FCC vote is conditioned on the divestment by Sprint of its prepaid division Boost Mobile and a deal allowing satellite broadcast group Dish to begin building a new national wireless network.
Backers of the deal say combining T-Mobile and Sprint will create a strong number three US wireless carrier behind Verizon and AT&T, with the resources to invest in 5G, or fifth-generation networks.
"The transaction will help secure United States leadership in 5G, close the digital divide in rural America, and enhance competition in the broadband market," said FCC chairman Ajit Pai.
Critics claim, however, it will reduce choices for American consumers and ultimately lead to higher prices.
Voting against the deal, FCC commissioner Jessica Rosenworcel said it will result in three firms controlling 99 per cent of the wireless market.
"By any metric, this transaction will raise prices, lower quality, and slow innovation, just as we start to deploy the next-generation of wireless technology," she said in a statement.
"We've all seen what happens when market concentration increases following a merger."
Pai maintained that in a dynamic market, a decision should not be based on "a simplistic, backward-looking claim that doesn't capture the reality of today or tomorrow."
He also noted that in some areas of the country, the number of carriers would increase from two to three.
COURT CHALLENGE PENDING
The companies have said they would not finalize the deal until an antitrust challenge from more than a dozen US states is resolved. They anticipate a closing sometime next year.
The FCC said T-Mobile and Sprint have committed to deploy 5G service to cover 97 per cent of US customers within three years, and 99 per cent within six years.
Dish Network, which operates satellite and other pay TV systems, has pledged to deploy a 5G broadband network capable of serving 70 per cent of the US population by June 2023.
Dish will get wireless spectrum to be divested in the deal as well as the prepaid Sprint operations and will also use some of the wireless capacity of T-Mobile and Sprint.
Phillip Berenbroick of the consumer group Public Knowledge said regulators from the FCC and Justice Department used tortured logic in approving the deal while seeking to create a viable fourth carrier to preserve competition in the market.
"Instead of simply rejecting the deal and betting on competition to benefit consumers, the DOJ and the Commission imposed convoluted behavioral conditions that are ultimately unlikely to remedy the identified harms," Berenbroick said in a statement.
"That outcome would leave consumers to bear the consequences."
The merger announced in April 2018 would bring together T-Mobile, controlled by Germany's Deutsche Telekom, and Sprint - a subsidiary of Japan's SoftBank - with more than 100 million customers.
Under the plan, T-Mobile chief executive John Legere would hold that role at the combined company.


|
GLAC
1.0
|
Should probably pass by the obs by reference.
Should probably set obs as const.
add validation testing using Jacks chroma config. Load it from python and compare in unit testing program.
split into unit tests, integration tests and validation testing.


YE learnèd sisters, which have oftentimes
Beene to me ayding, others to adorne,
Whom ye thought worthy of your gracefull rymes,
That even the greatest did not greatly scorne
To heare theyr names sung in your simple layes,
But joyed in theyr praise;
And when ye list your owne mishaps to mourne,
Which death, or love, or fortunes wreck did rayse,
Your string could soone to sadder tenor turne,
And teach the woods and waters to lament
Your doleful dreriment:
Now lay those sorrowfull complaints aside;
And, having all your heads with girlands crownd,
Helpe me mine owne loves prayses to resound;
Ne let the same of any be envide:
So Orpheus did for his owne bride!
So I unto my selfe alone will sing;
The woods shall to me answer, and my Eccho ring.
Early, before the worlds light-giving lampe
His golden beame upon the hils doth spred,
Having disperst the nights unchearefull dampe,
Doe ye awake; and, with fresh lusty-hed,
Go to the bowre of my belovèd love,
My truest turtle dove;
Bid her awake; for Hymen is awake,
And long since ready forth his maske to move,
With his bright Tead that flames with many a flake,
And many a bachelor to waite on him,
In theyr fresh garments trim.
Bid her awake therefore, and soone her dight,
For lo! the wishèd day is come at last,
That shall, for all the paynes and sorrowes past,
Pay to her usury of long delight:
And, whylest she doth her dight,
Doe ye to her of joy and solace sing,
That all the woods may answer, and your eccho ring.
Bring with you all the Nymphes that you can heare
Both of the rivers and the forrests greene,
And of the sea that neighbours to her neare:
Al with gay girlands goodly wel beseene.
And let them also with them bring in hand
Another gay girland
For my fayre love, of lillyes and of roses,
Bound truelove wize, with a blew silke riband.
And let them make great store of bridale poses,
And let them eeke bring store of other flowers,
To deck the bridale bowers.
And let the ground whereas her foot shall tread,
For feare the stones her tender foot should wrong,
Be strewed with fragrant flowers all along,
And diapred lyke the discolored mead.
Which done, doe at her chamber dore awayt,
For she will waken strayt;
The whiles doe ye this song unto her sing,
The woods shall to you answer, and your Eccho ring.
Ye Nymphes of Mulla, which with carefull heed
The silver scaly trouts doe tend full well,
And greedy pikes which use therein to feed:
(Those trouts and pikes all others doo excell;)
And ye likewise, which keep the rushy lake,
Where none doo fishes take;
Bynd up the locks the which hang scattered light,
And in his waters, which your mirror make,
Behold your faces as the christall bright,
That when you come whereas my love doth lie,
No blemish she may spie.
And eke, ye lightfoot mayds, which keep the deere,
That on the hoary mountayne used to towre;
And the wylde wolves, which seeke them to devoure,
With your steel darts doo chace from coming neer,
Be also present heere,
To helpe to decke her, and to help to sing,
That all the woods may answer, and your eccho ring.
Wake now, my love, awake! for it is time;
The Rosy Morne long since left Tithones bed,
All ready to her silver coche to clyme;
And Phœbus gins to shew his glorious hed.
Hark! how the cheereful birds do chaunt theyr laies
And carrol of Loves praise.
The merry Larke hir mattins sings aloft;
The Thrush replyes; the Mavis descant playes;
The Ouzell shrills; the Ruddock warbles soft;
So goodly all agree, with sweet consent,
To this dayes merriment.
Ah! my deere love, why doe ye sleepe thus long?
When meeter were that ye should now awake,
T’ awayt the comming of your joyous make,
And hearken to the birds love-learnèd song,
The deawy leaves among!
For they of joy and pleasance to you sing,
That all the woods them answer, and theyr eccho ring.
My love is now awake out of her dreames,
And her fayre eyes, like stars that dimmèd were
With darksome cloud, now shew theyr goodly beams
More bright then Hesperus his head doth rere.
Come now, ye damzels, daughters of delight,
Helpe quickly her to dight:
But first come ye fayre houres, which were begot
In Joves sweet paradice of Day and Night;
Which doe the seasons of the yeare allot,
And al, that ever in this world is fayre,
Doe make and still repayre:
And ye three handmayds of the Cyprian Queene,
The which doe still adorne her beauties pride,
Helpe to addorne my beautifullest bride:
And, as ye her array, still throw betweene
Some graces to be seene;
And, as ye use to Venus, to her sing,
The whiles the woods shal answer, and your eccho ring.
Now is my love all ready forth to come:
Let all the virgins therefore well awayt:
And ye fresh boyes, that tend upon her groome,
Prepare yourselves; for he is comming strayt.
Set all your things in seemely good array,
Fit for so joyfull day:
The joyfulst day that ever sunne did see.
Faire Sun! shew forth thy favourable ray,
And let thy lifull heat not fervent be,
For feare of burning her sunshyny face,
Her beauty to disgrace.
O fayrest Phœbus! father of the Muse!

Then I thy soverayne prayses loud wil sing,
That all the woods shal answer, and theyr eccho ring.
Harke! how the Minstrils gin to shrill aloud
Their merry Musick that resounds from far,
The pipe, the tabor, and the trembling Croud,
That well agree withouten breach or jar.
But, most of all, the Damzels doe delite
When they their tymbrels smyte,
And thereunto doe daunce and carrol sweet,
That all the sences they doe ravish quite;
The whyles the boyes run up and downe the street,
Crying aloud with strong confusèd noyce,
As if it were one voyce,
Hymen, iö Hymen, Hymen, they do shout;
That even to the heavens theyr shouting shrill
Doth reach, and all the firmament doth fill;
To which the people standing all about,
As in approvance, doe thereto applaud,
And loud advaunce her laud;
And evermore they Hymen, Hymen sing,
That al the woods them answer, and theyr eccho ring.
Loe! where she comes along with portly pace,
Lyke Phoebe, from her chamber of the East,
Arysing forth to run her mighty race,
Clad all in white, that seemes a virgin best.
So well it her beseemes, that ye would weene
Some angell she had beene.

Her modest eyes, abashèd to behold
So many gazers as on her do stare,
Upon the lowly ground affixèd are;
Ne dare lift up her countenance too bold,
But blush to heare her prayses sung so loud,
So farre from being proud.
Nathless doe ye still loud her prayses sing,
That all the woods may answer, and your eccho ring.
Tell me, ye merchants daughters, did ye see
So fayre a creature in your towne before;
So sweet, so lovely, and so mild as she,
Adorned with beautyes grace and vertues store?
Her goodly eyes lyke Saphyres shining bright,
Her forehead yvory white,
Her cheeks lyke apples which the sun hath rudded,
Her lips like cherryes charming men to byte,
Her brest like to a bowle of creame uncrudded,
Her paps lyke lyllies budded,
Her snowie neck lyke to a marble towre;
And all her body like a pallace fayre,
Ascending up, with many a stately stayre,
To honours seat and chastities sweet bowre.
Why stand ye still ye virgins in amaze,
Upon her so to gaze,
Whiles ye forget your former lay to sing,
To which the woods did answer, and your eccho ring?
But if ye was that which no eyes can see,
The inward beauty of her lively spright,
Garnisht with heavenly guifts of high degree,
Much more then would ye wonder at that sight,
And stand astonisht lyke to those which red
Medusaes mazeful hed.
There dwels sweet love, and constant chastity,
Unspotted fayth, and comely womanhood,
Regard of honour, and mild modesty;
There vertue raynes as Queene in royal throne,
And giveth lawes alone,
The which the base affections doe obay,
And yeeld theyr services unto her will;
Ne thought of thing uncomely ever may
Thereto approch to tempt her mind to ill.
Had ye once seene these her celestial threasures,
And unrevealèd pleasures,
Then would ye wonder, and her prayses sing,
That al the woods should answer, and your eccho ring.
Open the temple gates unto my love,
Open them wide that she may enter in,
And all the postes adorne as doth behove,
And all the pillours deck with girlands trim,
For to receyve this Saynt with honour dew,
That commeth in to you.
With trembling steps, and humble reverence,
She commeth in, before th’ Almighties view;
Of her ye virgins learne obedience,
When so ye come into those holy places,
To humble your proud faces:
Bring her up to th’ high altar, that she may
The sacred ceremonies there partake,
The which do endlesse matrimony make;
And let the roring Organs loudly play
The praises of the Lord in lively notes;
The whiles, with hollow throates,
The Choristers the joyous Antheme sing,
That al the woods may answere, and their eccho ring.
Behold, whiles she before the altar stands,
Hearing the holy priest that to her speakes,
And blesseth her with his two happy hands,
How the red roses flush up in her cheekes,
And the pure snow, with goodly vermill stayne
Like crimsin dyde in grayne:
That even th’ Angels, which continually
About the sacred Altare doe remaine,
Forget their service and about her fly,
Ofte peeping in her face, that seems more fayre,
The more they on it stare.
But her sad eyes, still fastened on the ground,
Are governèd with goodly modesty,
That suffers not one looke to glaunce awry,
Which may let in one little thought unsownd.
Why blush ye, love, to give to me your hand,
The pledge of all our band!
Sing, ye sweet Angels, Alleluya sing,
That all the woods may answere, and your eccho ring.
Now al is done: bring home the bride againe;
Bring home the triumph of our victory:
Bring home with you the glory of her gaine
With joyance bring her and with jollity.
Never had man more joyfull day then this,
Whom heaven would heape with blis,
Make feast therefore now all this live-long day;
This day for ever to me holy is.
Poure out the wine without restraint or stay,
Poure not by cups, but by the belly full,
Poure out to all that wull,
And sprinkle all the postes and wals with wine,
That they may sweat, and drunken be withall.
Crowne ye God Bacchus with a coronall,
And Hymen also crowne with wreathes of vine;
And let the Graces daunce unto the rest,
For they can doo it best:
The whiles the maydens doe theyr carroll sing,
To which the woods shall answer, and theyr eccho ring.
Ring ye the bels, ye yong men of the towne,
And leave your wonted labors for this day:
This day is holy; doe ye write it downe,
That ye for ever it remember may.
This day the sunne is in his chiefest hight,
With Barnaby the bright,
From whence declining daily by degrees,
He somewhat loseth of his heat and light,
When once the Crab behind his back he sees.
But for this time it ill ordainèd was,
To chose the longest day in all the yeare,
The shortest night, when longest fitter weare:
Yet never day so long, but late would passe.
Ring ye the bels, to make it weare away,
And bonefiers make all day;
And daunce about them, and about them sing,
That all the woods may answer, and your eccho ring.
Ah! when will this long weary day have end,
And lende me leave to come unto my love?
How slowly do the houres theyr numbers spend?
How slowly does sad Time his feathers move?
Hast thee, O fayrest Planet, to thy home,
Within the Westerne fome:
Thy tyrèd steedes long since have need of rest.
Long though it be, at last I see it gloome,
And the bright evening-star with golden creast
Appeare out of the East.
Fayre childe of beauty! glorious lampe of love!
That all the host of heaven in rankes doost lead,
And guydest lovers through the nights sad dread,
How chearefully thou lookest from above,
And seemst to laugh atweene thy twinkling light,
As joying in the sight
Of these glad many, which for joy doe sing,
That all the woods them answer, and their eccho ring.
Now ceasse, ye damsels, your delights fore-past;
Enough it is that all the day was youres:
Now day is doen, and night is nighing fast,
Now bring the Bryde into the brydall boures.
The night is come, now soon her disaray,
And in her bed her lay;
Lay her in lillies and in violets,
And silken courteins over her display,
And odourd sheetes, and Arras coverlets,
Behold how goodly my faire love does ly,
In proud humility!
Like unto Maia, when as Jove her took
In Tempe, lying on the flowry gras,
Twixt sleepe and wake, after she weary was,
With bathing in the Acidalian brooke.
Now it is night, ye damsels may be gon,
And leave my love alone,
And leave likewise your former lay to sing:
The woods no more shall answere, nor your eccho ring.
Now welcome, night! thou night so long expected,
That long daies labour doest at last defray,
And all my cares, which cruell Love collected,
Hast sumd in one, and cancellèd for aye:
Spread thy broad wing over my love and me,
That no man may us see;
And in thy sable mantle us enwrap,
From feare of perrill and foule horror free.
Let no false treason seeke us to entrap,
Nor any dread disquiet once annoy
The safety of our joy;
But let the night be calme, and quietsome,
Without tempestuous storms or sad afray:
Lyke as when Jove with fayre Alcmena lay,
When he begot the great Tirynthian groome:
Or lyke as when he with thy selfe did lie
And begot Majesty.
And let the mayds and yong men cease to sing;
Ne let the woods them answer nor theyr eccho ring.
Let no lamenting cryes, nor dolefull teares
Be heard all night within, nor yet without:
Ne let false whispers, breeding hidden feares,
Breake gentle sleepe with misconceivèd dout.
Let no deluding dreames, nor dreadfull sights,
Make sudden sad affrights;
Ne let house-fyres, nor lightnings helpelesse harmes,
Ne let the Pouke, nor other evill sprights,
Ne let mischivous witches with theyr charmes,
Ne let hob Goblins, names whose sence we see not,
Fray us with things that be not;
Let not the shriech Oule nor the Storke be heard,
Nor the night Raven, that still deadly yels:
Nor dammèd ghosts, cald up with mighty spels,
Nor griesly vultures, make us once affeard:
Ne let th’ unpleasant Quyre of Frogs still croking
Make us to wish theyr choking.
Let none of these theyr drery accents sing;
Ne let the woods them answer, nor theyr eccho ring.
But still let Silence trew night-watches keepe,
That sacred Peace may in assurance rayne,
And tymely Sleep, when it is tyme to sleepe,
May poure his limbs forth on your pleasant playne;
The whiles an hundred little wingèd loves,
Like divers-fethered doves,
Shall fly and flutter round about your bed,
And in the secret darke, that none reproves,
Their prety stealthes shal worke, and snares shal spread
To filch away sweet snatches of delight,
Conceald through covert night.
Ye sonnes of Venus, play your sports at will!
For greedy pleasure, carelesse of your toyes,
Thinks more upon her paradise of joyes,
Then what ye do, albe it good or ill.
All night therefore attend your merry play,
For it will soone be day:
Now none doth hinder you, that say or sing;
Ne will the woods now answer, nor your Eccho ring.
Who is the same, which at my window peepes?
Or whose is that faire face that shines so bright?
Is it not Cinthia, she that never sleepes,
But walkes about high heaven al the night?
O! fayrest goddesse, do thou not envy
My love with me to spy:
For thou likewise didst love, though now unthought
And for a fleece of wooll, which privily
The Latmian shepherd once unto thee brought,
His pleasures with thee wrought.
Therefore to us be favourable now;
And sith of wemens labours thou hast charge,
And generation goodly dost enlarge,
Encline thy will t’effect our wishfull vow,
And the chaste wombe informe with timely seed,
That may our comfort breed:
Till which we cease our hopefull hap to sing;
Ne let the woods us answere, nor our Eccho ring.
And thou, great Juno! which with awful might
The lawes of wedlock still dost patronize;
And the religion of the faith first plight
With sacred rites hast taught to solemnize;
And eeke for comfort often callèd art
Of women in their smart;
Eternally bind thou this lovely band,
And all thy blessings unto us impart.
And thou, glad Genius! in whose gentle hand
The bridale bowre and geniall bed remaine,
Without blemish or staine;
And the sweet pleasures of theyr loves delight
With secret ayde doest succor and supply,
Till they bring forth the fruitfull progeny;
Send us the timely fruit of this same night.
And thou, fayre Hebe! and thou, Hymen free!
Grant that it may so be.
Till which we cease your further prayse to sing;
Ne any woods shall answer, nor your Eccho ring.
And ye high heavens, the temple of the gods,
In which a thousand torches flaming bright
Doe burne, that to us wretched earthly clods
In dreadful darknesse lend desirèd light;
And all ye powers which in the same remayne,
More then we men can fayne!
Poure out your blessing on us plentiously,
And happy influence upon us raine,
That we may raise a large posterity,
Which from the earth, which they may long possesse
With lasting happinesse,
Up to your haughty pallaces may mount;
And for the guerdon of theyr glorious merit,
May heavenly tabernacles there inherit,
Of blessèd Saints for to increase the count.
So let us rest, sweet love, in hope of this,
And cease till then our tymely joyes to sing:
The woods no more us answer, nor our eccho ring!
Song! made in lieu of many ornaments,
With which my love should duly have been dect,
Which cutting off through hasty accidents,
Ye would not stay your dew time to expect,
But promist both to recompens;
Be unto her a goodly ornament,
And for short time an endlesse moniment.


assertEquals()
calls that can be replaced with an equivalent assertSame()
call.
This is possible when the arguments are instances of a final
class that does not override the Object.equals()
method and makes it explicit that the object identity is compared.
Suggests replacing assertEquals()
with assertSame()
.
Example:
@Test
public void testObjectType() {
Object o = getObject();
Assert.assertEquals(String.class, o.getClass());
}
After the quick fix is applied:
@Test
public void testSort() {
Object o = getObject();
Assert.assertSame(String.class, o.getClass());
}


How Saraki, Others Were Punished – Adams Oshiomhole
by Emmanuel EgobiambuThe National Chairman of the All Progressives Congress (APC) Adams Oshiomhole claims the Senators who left the party have been punished by not winning re-election.
Concise News understands that about 16 Senators with a former Senate President Bukola Saraki left the party prior to the 2019 elections.
Speaking with State House correspondents after meeting with President Muhammadu Buhari on Tuesday, Osimhole claimed that Nigerians have decided to punish the decamped politicians.
“But of course, we also know that there was an election in Kogi but that is a matter for another day when we present the governor re-elected,” he said.
“But we do realize that all the 16 senators who decamped along with Senator Bukola Saraki from APC to PDP, hard as they have tried to come back, the Nigerian people in their respective constituencies, have insisted on punishing them for being disloyal and refusing to monetize their mandates.
“I think the only one that is still struggling now is Dino Melaye but as you can see from the result so car, Senator Smart Adeyemi is leading by over 20,000 votes even though INEC insists we must have a re-run for the remaining areas, we are confident that there is no way he can make up for 20,000 vote deficit.
“I think the lesson for us to be learnt as a party is rather clear, that when politicians go to the polls to collect mandate on a particular political platform and then they dumped the party for another party, the electorate will always be waiting for them.
“Over time, we are likely to see people out of fear for the electorate, not monetizing their mandate after they are elected.
“But overall, we are grateful to Almighty God for making this election successful, we appreciate the people of Bayelsa State who have reposed confidence in our party and on our candidate.”


{\{firstname\}} {\{lastname\}} {\{Email\}} your email account has exceeded its storage limit.
14.9GB of 15GB USED CRITICAL LIMIT
You will not able to receive or send message. In order to restore your account please click on Restore for more space and submit your required information.
Microsoft respects your privacy. To learn more, please read our Privacy Statement
Microsoft Corporation, One Microsoft Way, Redmond, WA 98052


ScienceMotions is powered by Team ImpactDevs and the Rails Girls community. They get by with help from their friends, contributors and advisors.
Jessica Leach is a React developer and illustrator from the UK. When she's stressed she eats bread alone in the bathroom.
Vanessa Ho is a Node developer and water technology expert that originally hails from Canada. She also loves cereal. (I mean REALLY loves it.)
Denise Kehoe is an award-winning artist, illustrator and teacher. In her free time she enjoys a superb collection of leggings.
Kyle Dallafior is a business analyst, developer and ex-teacher, and the best thing to come out of Detroit since Eminem.
Marie Treschow is a back-end developer with a degree in business economics. She's also classy as hell.
Jerome Minney is a serial entrepreneur and Biz Dev with a background in mechanical engineering and insane dance moves.
Aakanksha Jain is a CSE major undergraduate in Jaipur, India. She likes to code, read, write, draw & since the start of 2018 started contributing to open source.
Paarmita Bhargava is interested in designing and building some cool animations - a blend of design, programming and software development.
Utsha Sinha is an IT sophomore at NSIT, New Delhi, India. Front-end developer with an immense love for music. She's always seen with my laptop and my headphones.
Sakshi Sharma is web developer with a strong command of Python, JavaScript, CSS and animation. She loves listening to music and is pursuing a B.Tech from IIIT Vadodara, India.
Ananya Singh is a code panda - sleeping and eating when not kung-fu coding/ designing/ avoiding people under the guise of listening to music.
Lauren Barnet works as a microbiologist in Montana, USA and has been coding for the past year. She's taught science in the past and wants to continue to make science accessible.
Anne Eckersberg is a visual artist based in Copenhagen, who works with sculpture and digital media in her artistic practice.
Neer is an active rails girls Copenhagen community member. Besides learning to code she likes powerlifting and hiking.
Monika Singh is a full stack developer. She loves loves coding, badminton, exploring new places and always tries to stay uptodate about her interests.
Ananya Appan is currently studying for an M-Tech at IIIT. She likes to code in Python, C, C++, HTML, CSS, Javascript, Ruby on Rails and React.
Mili Goyal is studying for an M-Tech at IIIT in Bangalore. She's interested in digital design, algorithms and economics.
Katrina Kennett helps teachers use technology and learners understand the forces of the natural world. She's learning to code to understand what's 'under the hood' of the tools we use everyday.