Fixed async task notifications; added more comments; restored CancellationToken methods; removed useless usings

git-svn-id: file:///srv/devel/repo-conversion/nusu@330 d2e56fa2-650e-0410-a79f-9358c0239efd

Properties/AssemblyInfo.cs

@@ -9,7 +9,7 @@ using System.Runtime.InteropServices;
 [assembly: AssemblyProduct("Nuclex.Support")]
 [assembly: AssemblyDescription("")]
 [assembly: AssemblyCompany("Nuclex Development Labs")]
-[assembly: AssemblyCopyright("Copyright © Nuclex Development Labs 2008-2013")]
+[assembly: AssemblyCopyright("Copyright © Nuclex Development Labs 2008-2017")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]
 

Source/Async/IAsyncAction.cs

@@ -19,6 +19,7 @@ License along with this library
 #endregion
 
 using System;
+using System.Threading;
 
 namespace Nuclex.Support.Async {
 
@@ -28,11 +29,9 @@ namespace Nuclex.Support.Async {
     /// <summary>Executes the action</summary>
     void Run();
 
-#if false
     /// <summary>Executes the action allowing cancellation via a cancellation token</summary>
     /// <param name="cancellationToken">Cancellation token that can cancel the action</param>
     void Run(CancellationToken cancellationToken);
-#endif
 
   }
 

Source/Async/IAsyncSwitch.cs

@@ -19,6 +19,7 @@ License along with this library
 #endregion
 
 using System;
+using System.Threading;
 
 namespace Nuclex.Support.Async {
 
@@ -30,14 +31,12 @@ namespace Nuclex.Support.Async {
     /// <param name="option">Option or configuration to switch to</param>
     void Switch(TOptions option);
 
-#if false
     /// <summary>Switches to a different option or configuration</summary>
     /// <param name="option">Option or configuration to switch to</param>
     /// <param name="cancellationToken">
     ///   Cancellation token by which the switch can be cancelled
     /// </param>
     void Switch(TOptions option, CancellationToken cancellationToken);
-#endif
 
     /// <summary>Current target option or configuration being switched to</summary>
     TOptions Target { get; }

Source/Async/IAsyncTask.cs

@@ -25,14 +25,11 @@ namespace Nuclex.Support.Async {
   /// <summary>Task that runs in the background or externally</summary>
   public interface IAsyncTask {
 
-    /// <summary>Triggered when the process starts running</summary>
-    event EventHandler Started;
+    /// <summary>Triggered when the status of the task changes</summary>
+    event EventHandler<AsyncStatusEventArgs> StatusChanged;
 
-    /// <summary>Triggered when the action finishes for any reason</summary>
-    event EventHandler Finished;
-
-    /// <summary>Whether the action is currently running</summary>
-    bool IsRunning { get;  }
+    /// <summary>Current status of the asynchronous task</summary>
+    AsyncStatus Status { get; }
 
   }
 

Source/Collections/Deque.Insertion.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Collections;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/Deque.Removal.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Collections;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/Deque.Search.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Collections;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/Deque.cs

@@ -21,7 +21,6 @@ License along with this library
 using System;
 using System.Collections.Generic;
 using System.Collections;
-using System.Reflection;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/IObservableCollection.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Collections.ObjectModel;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/ItemEventArgs.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/ItemReplaceEventArgs.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/ObservableSet.cs

@@ -20,7 +20,6 @@ License along with this library
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using System.Collections;
 
 #if !NO_SPECIALIZED_COLLECTIONS

Source/Collections/Parentable.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/ParentingCollection.cs

@@ -19,10 +19,7 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Collections.ObjectModel;
-using System.IO;
-using System.Reflection;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/Pool.cs

@@ -20,7 +20,6 @@ License along with this library
 
 using System;
 using System.Collections.Generic;
-using System.Text;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/PriorityItemPair.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Text;
 
 namespace Nuclex.Support.Collections {

Source/Collections/ReadOnlyDictionary.cs

@@ -21,7 +21,6 @@ License along with this library
 using System;
 using System.Collections.Generic;
 using System.Collections;
-using System.Collections.ObjectModel;
 using System.Runtime.Serialization;
 
 namespace Nuclex.Support.Collections {

Source/Collections/TransformingReadOnlyCollection.cs

@@ -21,7 +21,6 @@ License along with this library
 using System;
 using System.Collections;
 using System.Collections.Generic;
-using System.Collections.ObjectModel;
 
 namespace Nuclex.Support.Collections {
 

Source/Collections/WeakCollection.cs

@@ -21,7 +21,6 @@ License along with this library
 using System;
 using System.Collections;
 using System.Collections.Generic;
-using System.Collections.ObjectModel;
 
 namespace Nuclex.Support.Collections {
 

Source/EnumHelper.cs

@@ -19,9 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Reflection;
 
 namespace Nuclex.Support {
 

Source/FloatHelper.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Runtime.InteropServices;
 
 namespace Nuclex.Support {

Source/IO/ChainStream.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
 

Source/IO/PartialStream.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Diagnostics;
 using System.IO;
 
 namespace Nuclex.Support.IO {

Source/IntegerHelper.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 
 namespace Nuclex.Support {
 

Source/Licensing/LicenseKey.cs

@@ -20,7 +20,6 @@ License along with this library
 
 using System;
 using System.Collections;
-using System.IO;
 using System.Text;
 
 namespace Nuclex.Support.Licensing {

Source/Observable.cs

@@ -64,6 +64,7 @@ namespace Nuclex.Support {
     ///     </code>
     ///   </example>
     /// </remarks>
+    [Obsolete("Prefer the C# 'nameof()' operator to using a Linq expression")]
     protected void OnPropertyChanged<TProperty>(Expression<Func<TProperty>> property) {
       PropertyChangedEventHandler copy = PropertyChanged;
       if(copy != null) {

Source/ParallelBackgroundWorker.cs

@@ -20,7 +20,7 @@ License along with this library
 
 #if !NO_CONCURRENT_COLLECTIONS
 
-using System;
+using System;
 using System.Collections.Concurrent;
 using System.Collections.Generic;
 using System.Threading;

Source/Parsing/CommandLine.Argument.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Diagnostics;
 
 namespace Nuclex.Support.Parsing {
 

Source/Parsing/CommandLine.Formatter.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Text;
 
 namespace Nuclex.Support.Parsing {

Source/Parsing/CommandLine.Parser.cs

@@ -20,8 +20,6 @@ License along with this library
 
 using System;
 using System.Collections.Generic;
-using System.Diagnostics;
-using System.IO;
 
 namespace Nuclex.Support.Parsing {
 

Source/Parsing/CommandLine.Test.cs

@@ -19,8 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
-using System.Text;
 
 #if UNITTEST
 

Source/Parsing/CommandLine.cs

@@ -23,8 +23,6 @@ using System.Collections.Generic;
 using System.IO;
 using System.Text;
 
-using Nuclex.Support.Collections;
-
 namespace Nuclex.Support.Parsing {
 
   /// <summary>Parses and stores an application's command line parameters</summary>

Source/PropertyChangedEventArgsHelper.cs

@@ -72,6 +72,7 @@ namespace Nuclex.Support {
     ///     </code>
     ///   </example>
     /// </remarks>
+    [Obsolete("Prefer the C# 'nameof()' operator to using a Linq expression")]
     public static PropertyChangedEventArgs GetArgumentsFor<TValue>(
       Expression<Func<TValue>> property
     ) {
@@ -160,6 +161,7 @@ namespace Nuclex.Support {
     ///     </code>
     ///   </example>
     /// </remarks>
+    [Obsolete("Prefer the C# 'nameof()' operator to using a Linq expression")]
     public static bool AreAffecting<TValue>(
       this PropertyChangedEventArgs arguments, Expression<Func<TValue>> property
     ) {

Source/StringHelper.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 
 namespace Nuclex.Support {
 

Source/StringSegment.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Runtime.InteropServices;
 
 namespace Nuclex.Support {

Source/WeakReference.cs

@@ -19,7 +19,6 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.Runtime.Serialization;
 
 namespace Nuclex.Support {

Source/XmlHelper.cs

@@ -19,9 +19,7 @@ License along with this library
 #endregion
 
 using System;
-using System.Collections.Generic;
 using System.IO;
-using System.Reflection;
 using System.Xml;
 #if !USE_XMLDOCUMENT
 using System.Xml.Linq;