mcs/class/System/System.ComponentModel/AsyncOperation.cs

   1 //
   2 // AsyncOperation.cs
   3 //
   4 // Authors:
   5 //      Atsushi Enomoto <atsushi@ximian.com>
   6 //
   7 // Copyright (C) 2006 Novell, Inc.
   8 //
   9
  10 //
  11 // Permission is hereby granted, free of charge, to any person obtaining
  12 // a copy of this software and associated documentation files (the
  13 // "Software"), to deal in the Software without restriction, including
  14 // without limitation the rights to use, copy, modify, merge, publish,
  15 // distribute, sublicense, and/or sell copies of the Software, and to
  16 // permit persons to whom the Software is furnished to do so, subject to
  17 // the following conditions:
  18 //
  19 // The above copyright notice and this permission notice shall be
  20 // included in all copies or substantial portions of the Software.
  21 //
  22 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  23 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  24 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  25 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  26 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  27 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  28 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  29 //
  30 using System.Threading;
  31
  32 namespace System.ComponentModel
  33 {
  34         public sealed class AsyncOperation
  35         {
  36                 internal AsyncOperation (SynchronizationContext ctx,
  37                                          object state)
  38                 {
  39                         this.ctx = ctx;
  40                         this.state = state;
  41
  42                         ctx.OperationStarted ();
  43                 }
  44
  45                 ~AsyncOperation ()
  46                 {
  47                         if (!done && ctx != null)
  48                                 ctx.OperationCompleted ();
  49                 }
  50
  51                 SynchronizationContext ctx;
  52                 object state;
  53                 bool done;
  54
  55                 public SynchronizationContext SynchronizationContext {
  56                         get { return ctx; }
  57                 }
  58
  59                 public object UserSuppliedState {
  60                         get { return state; }
  61                 }
  62
  63                 public void OperationCompleted ()
  64                 {
  65                         if (done)
  66                                 throw new InvalidOperationException ("This task is already completed. Multiple call to OperationCompleted is not allowed.");
  67
  68                         ctx.OperationCompleted ();
  69
  70                         done = true;
  71                 }
  72
  73                 public void Post (SendOrPostCallback d, object arg)
  74                 {
  75                         if (d == null)
  76                                 throw new ArgumentNullException ("d");
  77
  78                         if (done)
  79                                 throw new InvalidOperationException ("This task is already completed. Multiple call to Post is not allowed.");
  80
  81                         ctx.Post (d, arg);
  82                 }
  83
  84                 public void PostOperationCompleted (
  85                         SendOrPostCallback d, object arg)
  86                 {
  87                         if (d == null)
  88                                 throw new ArgumentNullException ("d");
  89
  90                         if (done)
  91                                 throw new InvalidOperationException ("This task is already completed. Multiple call to PostOperationCompleted is not allowed.");
  92
  93                         Post (d, arg);
  94                         OperationCompleted ();
  95                 }
  96         }
  97 }