推荐一个winform 界面交互类库

爱被打了一巴掌 2021-12-23 02:09 262阅读 0赞

这个类库是在codeproject上发现的，主要是用于在.net 2.0,3.5的框架下，不可以在非创建线程下雨控件进行交互的限制，类库封装得比较好，使用了匿名方法。

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][] Code   
![None.gif][]// Copyright (c) 2008 CodeToast.com and Nicholas Brookins  
![None.gif][]//This code is free to use in any application for any use if this notice is left intact.  
![None.gif][]//Just don't sue me if it gets you fired.  Enjoy!  
![None.gif][]  
![None.gif][]using System;  
![None.gif][]using System.Collections.Generic;  
![None.gif][]using System.Reflection;  
![None.gif][]using System.Text;  
![None.gif][]using System.Runtime.Remoting.Messaging;  
![None.gif][]using System.Threading;  
![None.gif][]using System.Windows.Forms;  
![None.gif][]  
![ExpandedBlockStart.gif][]![ContractedBlock.gif][]namespace CodeToast ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public static class Async ![dot.gif][]\{  
![InBlock.gif][]  
![InBlock.gif][]        static Dictionary<string, object> methodLocks = new Dictionary<string, object>();  
![InBlock.gif][]  
![ContractedSubBlock.gif][]![ExpandedSubBlockStart.gif][]        Async 'Do' overloads, for ease of use\#region Async 'Do' overloads, for ease of use  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.   
![InBlock.gif][]        /// This overload always tries the ThreadPool and DOES NOT check for reentrance.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A delegate with a return value of some sort - can be cast to (DlgR) from an anonymous delgate with a return: Async.Do((DlgR)MyMethod);</param>  
![InBlock.gif][]        /// <param name="getRetVal">If true, and the method/delgete returns something, it is included in the AsyncRes returned (after the method completes)</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes Do(DlgR d, bool getRetVal) ![dot.gif][]\{  
![InBlock.gif][]            return Do(d, getRetVal, ReenteranceMode.Allow);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.   
![InBlock.gif][]        /// This overload always tries the ThreadPool and DOES NOT check for reentrance.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A void delegate - can be cast to (Dlg) from an anonymous delgate or method:  Async.Do((Dlg)MyVoidMethod)</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes Do(Dlg d) ![dot.gif][]\{  
![InBlock.gif][]            return Do(d, ReenteranceMode.Allow);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A delegate with a return value of some sort - can be cast to (DlgR) from an anonymous delgate with a return: Async.Do((DlgR)MyMethod);</param>  
![InBlock.gif][]        /// <param name="rMode">If true, will make sure no other instances are running your method.</param>  
![InBlock.gif][]        /// <param name="getRetVal">If true, and the method/delgete returns something, it is included in the AsyncRes returned (after the method completes)</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, resturn and result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes Do(DlgR d, bool getRetVal, ReenteranceMode rMode) ![dot.gif][]\{  
![InBlock.gif][]            return Do(d, null, getRetVal, null, true, rMode, null, true);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A void delegate - can be cast to (Dlg) from an anonymous delgate or method:  Async.Do((Dlg)MyVoidMethod);</param>  
![InBlock.gif][]  
![InBlock.gif][]        /// <param name="rMode">If true, will make sure no other instances are running your method.</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes Do(Dlg d, ReenteranceMode rMode) ![dot.gif][]\{  
![InBlock.gif][]            return Do(null, d, false, null, true, rMode, null, true);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A delegate with a return value of some sort - can be cast to (DlgR) from an anonymous delgate with a return: Async.Do((DlgR)MyMethod);</param>  
![InBlock.gif][]        /// <param name="state">A user object that can be tracked through the returned result</param>  
![InBlock.gif][]        /// <param name="tryThreadPool">True to use the TP, otherwise just go to a ful lthread - good for long running tasks.</param>  
![InBlock.gif][]        /// <param name="rMode">If true, will make sure no other instances are running your method.</param>  
![InBlock.gif][]        /// <param name="getRetVal">If true, and the method/delgete returns something, it is included in the AsyncRes returned (after the method completes)</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, resturn and result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes Do(DlgR d, bool getRetVal, object state, bool tryThreadPool, ReenteranceMode rMode) ![dot.gif][]\{  
![InBlock.gif][]            return Do(d, null, getRetVal, state, tryThreadPool, rMode, null, true);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A void delegate - can be cast to (Dlg) from an anonymous delgate or method:  Async.Do((Dlg)MyVoidMethod);</param>  
![InBlock.gif][]        /// <param name="state">A user object that can be tracked through the returned result</param>  
![InBlock.gif][]        /// <param name="tryThreadPool">True to use the TP, otherwise just go to a ful lthread - good for long running tasks.</param>  
![InBlock.gif][]        /// <param name="rMode">If true, will make sure no other instances are running your method.</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes Do(Dlg d, object state, bool tryThreadPool, ReenteranceMode rMode) ![dot.gif][]\{  
![InBlock.gif][]            return Do(null, d, false, state, tryThreadPool, rMode, null, true);  
![ExpandedSubBlockEnd.gif][]        \}  
![ExpandedSubBlockEnd.gif][]        \#endregion  
![InBlock.gif][]  
![ContractedSubBlock.gif][]![ExpandedSubBlockStart.gif][]        The Big Main private 'Do' method - called by all overloads.\#region The Big Main private 'Do' method - called by all overloads.  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate asyncronously, using the threadpool or a full managed thread if needed.  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A void delegate - can be cast to (Dlg) from an anonymous delgate.</param>  
![InBlock.gif][]        /// <param name="dr">A delegate with a return value of some sort - can be cast to (DlgR) from an anonymous delgate with a return.</param>  
![InBlock.gif][]        /// <param name="state">A user object that can be tracked through the returned result</param>  
![InBlock.gif][]        /// <param name="getRetVal">If true, and the method/delgete returns something, it is included in the AsyncRes returned (after the method completes)</param>  
![InBlock.gif][]        /// <param name="tryThreadPool">True to use the TP, otherwise just go to a ful lthread - good for long running tasks.</param>  
![InBlock.gif][]        /// <param name="rMode">If true, will make sure no other instances are running your method.</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        private static AsyncRes Do(DlgR dr, Dlg d, bool getRetVal, object state, bool tryThreadPool, ReenteranceMode rMode, Control control, bool async) ![dot.gif][]\{  
![InBlock.gif][]            //get a generic MethodInfo for checks..  
![InBlock.gif][]            MethodInfo mi = ((dr != null) ? dr.Method : d.Method);  
![InBlock.gif][]            //make a unique key for output usage  
![InBlock.gif][]            string key = string.Format("\{0\}\{1\}\{2\}\{3\}", ((getRetVal) ? "<-" : ""), mi.DeclaringType, ((mi.IsStatic) ? ":" : "."), mi.Name);  
![InBlock.gif][]            //our custom return value, holds our delegate, state, key, etc.  
![InBlock.gif][]            AsyncRes res = new AsyncRes(state, ((dr != null) ? (Delegate)dr : (Delegate)d), key, rMode);  
![InBlock.gif][]  
![InBlock.gif][]            //Create a delegate wrapper for what we will actually invoke..  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            Dlg dlg = (Dlg)delegate ![dot.gif][]\{  
![InBlock.gif][]                if (!BeforeInvoke(res)) return; //checks for reentrance issues and sets us up  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                try ![dot.gif][]\{  
![InBlock.gif][]                    if (res.IsCompleted) return;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    if (dr != null) ![dot.gif][]\{  
![InBlock.gif][]                        res.retVal = dr();//use this one if theres a return  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    \} else ![dot.gif][]\{  
![InBlock.gif][]                        d();//otherwise the simpler dlg  
![ExpandedSubBlockEnd.gif][]                    \}  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                \} catch (Exception ex) ![dot.gif][]\{ //we never want a rogue exception on a random thread, it can't bubble up anywhere  
![InBlock.gif][]                    Console.WriteLine("Async Exception:" \+ ex);  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                \} finally ![dot.gif][]\{  
![InBlock.gif][]                    FinishInvoke(res);//this will fire our callback if they used it, and clean up  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockEnd.gif][]            \};  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            if (control != null) ![dot.gif][]\{  
![InBlock.gif][]                res.control = control;  
![InBlock.gif][]                res.result = AsyncAction.ControlInvoked;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                if (!async) ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    if (!control.InvokeRequired) ![dot.gif][]\{  
![InBlock.gif][]                        res.completedSynchronously = true;  
![InBlock.gif][]                        dlg();  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    \} else ![dot.gif][]\{  
![InBlock.gif][]                        control.Invoke(dlg);  
![ExpandedSubBlockEnd.gif][]                    \}  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                \} else ![dot.gif][]\{  
![InBlock.gif][]                    control.BeginInvoke(dlg);  
![ExpandedSubBlockEnd.gif][]                \}  
![InBlock.gif][]                return res;  
![ExpandedSubBlockEnd.gif][]            \} //don't catch these errors - if this fails, we shouldn't try a real thread or threadpool!  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            if (tryThreadPool) ![dot.gif][]\{ //we are going to use the .NET threadpool  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                try ![dot.gif][]\{  
![InBlock.gif][]                    //get some stats - much better than trying and silently failing or throwing an expensive exception  
![InBlock.gif][]                    int minThreads, minIO, threads, ioThreads, totalThreads, totalIO;  
![InBlock.gif][]                    ThreadPool.GetMinThreads(out minThreads, out minIO);  
![InBlock.gif][]                    ThreadPool.GetAvailableThreads(out threads, out ioThreads);  
![InBlock.gif][]                    ThreadPool.GetMaxThreads(out totalThreads, out totalIO);  
![InBlock.gif][]  
![InBlock.gif][]                    //check for at least our thread plus one more in ThreadPool  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    if (threads > minThreads) ![dot.gif][]\{  
![InBlock.gif][]                        //this is what actually fires this task off..  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                        bool result = ThreadPool.QueueUserWorkItem((WaitCallback)delegate ![dot.gif][]\{ dlg(); \});  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                        if (result) ![dot.gif][]\{  
![InBlock.gif][]                            res.result = AsyncAction.ThreadPool;  
![InBlock.gif][]                            //this means success in queueing and running the item  
![InBlock.gif][]                            return res;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                        \} else ![dot.gif][]\{  
![InBlock.gif][]                            //according to docs, this "won't ever happen" - exception instead, but just for kicks.  
![InBlock.gif][]                            Console.WriteLine( "Failed to queue in threadpool.", "Method: " \+ key);  
![ExpandedSubBlockEnd.gif][]                        \}  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    \} else ![dot.gif][]\{  
![InBlock.gif][]                        Console.WriteLine(String.Format("Insufficient idle threadpool threads: \{0\} of \{1\} - min \{2\}, Method: \{3\}", threads, totalThreads, minThreads, key));  
![ExpandedSubBlockEnd.gif][]                    \}  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                \} catch (Exception ex) ![dot.gif][]\{  
![InBlock.gif][]                    Console.WriteLine("Failed to queue in threadpool: " \+ ex.Message, "Method: " \+ key);  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockEnd.gif][]            \}  
![InBlock.gif][]  
![InBlock.gif][]            //if we got this far, then something up there failed, or they wanted a dedicated thread  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            Thread t = new Thread((ThreadStart)delegate ![dot.gif][]\{ dlg(); \});  
![InBlock.gif][]            t.IsBackground = true; //this or threadpriority are candidates for additional settings  
![InBlock.gif][]            t.Name = "Async\_" \+ key;  
![InBlock.gif][]            res.result = AsyncAction.Thread;  
![InBlock.gif][]            t.Start();  
![InBlock.gif][]  
![InBlock.gif][]            return res;  
![ExpandedSubBlockEnd.gif][]        \}  
![ExpandedSubBlockEnd.gif][]        \#endregion  
![InBlock.gif][]  
![ContractedSubBlock.gif][]![ExpandedSubBlockStart.gif][]        Before and after - helper methods\#region Before and after - helper methods  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        private static bool BeforeInvoke(AsyncRes res) ![dot.gif][]\{  
![InBlock.gif][]            //if marked as completed then we abort.  
![InBlock.gif][]            if (res.IsCompleted) return false;  
![InBlock.gif][]            //if mode is 'allow' there is nothing to check.  Otherwise![dot.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            if (res.RMode != ReenteranceMode.Allow) ![dot.gif][]\{  
![InBlock.gif][]                //be threadsafe with our one and only member field  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                lock (methodLocks) ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    if (!methodLocks.ContainsKey(res.Method)) ![dot.gif][]\{  
![InBlock.gif][]                        //make sure we have a generic locking object in the collection, it will already be there if we are reentering  
![InBlock.gif][]                        methodLocks.Add(res.Method, new object());  
![ExpandedSubBlockEnd.gif][]                    \}  
![InBlock.gif][]                    //if bypass mode and we can't get or lock, we dump out.  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    if (res.RMode == ReenteranceMode.Bypass) ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                        if (!Monitor.TryEnter(methodLocks\[res.Method\])) ![dot.gif][]\{  
![InBlock.gif][]                            res.result = AsyncAction.Reenterant;  
![InBlock.gif][]                            return false;  
![ExpandedSubBlockEnd.gif][]                        \}  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    \} else ![dot.gif][]\{  
![InBlock.gif][]                        //Otherwise in 'stack' mode, we just wait until someone else releases it![dot.gif][]  
![InBlock.gif][]                        Monitor.Enter(methodLocks\[res.Method\]);  
![ExpandedSubBlockEnd.gif][]                    \}  
![InBlock.gif][]  
![InBlock.gif][]                    //if we are here, all is good.    
![InBlock.gif][]                    //Set some properties on the result class to show when we started, and what thread we are on  
![InBlock.gif][]                    res.isStarted = true;  
![InBlock.gif][]                    res.startTime = DateTime.Now;  
![InBlock.gif][]                    res.thread = Thread.CurrentThread;  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockEnd.gif][]            \}  
![InBlock.gif][]  
![InBlock.gif][]            return true;  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        private static void FinishInvoke(AsyncRes res) ![dot.gif][]\{  
![InBlock.gif][]            if (res == null) return;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            try ![dot.gif][]\{  
![InBlock.gif][]                //finish a few more properties  
![InBlock.gif][]                res.isCompleted = true;  
![InBlock.gif][]                res.completeTime = DateTime.Now;  
![InBlock.gif][]                //set the resetevent, in case someone is using the waithandle to know when we have completed.  
![InBlock.gif][]                res.mre.Set();  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            \} catch (Exception ex) ![dot.gif][]\{  
![InBlock.gif][]                Console.WriteLine("Error setting wait handle on " \+ (res.Method ?? "NULL") \+ ex);  
![ExpandedSubBlockEnd.gif][]            \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            if (res.RMode != ReenteranceMode.Allow) ![dot.gif][]\{  
![InBlock.gif][]                //if mode is bypass or stack, then we must have a lock that needs releasing  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                try ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                    if (methodLocks.ContainsKey(res.Method)) ![dot.gif][]\{  
![InBlock.gif][]                        Monitor.Exit(methodLocks\[res.Method\]);  
![ExpandedSubBlockEnd.gif][]                    \}  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]                \} catch (Exception ex) ![dot.gif][]\{  
![InBlock.gif][]                    Console.WriteLine("Error releasing reentrant lock on " \+ (res.Method ?? "NULL")\+ ex);  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockEnd.gif][]            \}  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockEnd.gif][]        \#endregion  
![InBlock.gif][]  
![ContractedSubBlock.gif][]![ExpandedSubBlockStart.gif][]        UI Overloads\#region UI Overloads  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate, carefully using the correct UI thread  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A void delegate - can be cast to (Dlg) from an anonymous delgate or method:  Async.Do((Dlg)MyVoidMethod);</param>  
![InBlock.gif][]        /// <param name="async">Whether to run async, or try on current thread if invoke is not required.</param>  
![InBlock.gif][]        /// <param name="c">A control to Invoke upon GUI thread of, if needed. Null if unused.</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes UI(Dlg d, Control c, bool async) ![dot.gif][]\{  
![InBlock.gif][]            return Do(null, d, false, null, false, ReenteranceMode.Allow, c, async);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate, carefully using the correct UI thread  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A delegate with a return value of some sort - can be cast to (DlgR) from an anonymous delgate with a return: Async.Do((DlgR)MyMethod);</param>  
![InBlock.gif][]        /// <param name="async">Whether to run async, or try on current thread if invoke is not required.</param>  
![InBlock.gif][]        /// <param name="getRetVal">If true, and the method/delgete returns something, it is included in the AsyncRes returned (after the method completes)</param>  
![InBlock.gif][]        /// <param name="c">A control to Invoke upon GUI thread of, if needed. Null if unused.</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes UI(DlgR d, bool getRetVal, Control c, bool async) ![dot.gif][]\{  
![InBlock.gif][]            return Do(d, null, getRetVal, null, false, ReenteranceMode.Allow, c, async);  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Fires off your delegate, carefully using the correct UI thread  
![InBlock.gif][]        /// </summary>  
![InBlock.gif][]        /// <param name="d">A delegate with a return value of some sort - can be cast to (DlgR) from an anonymous delgate with a return: Async.Do((DlgR)MyMethod);</param>  
![InBlock.gif][]        /// <param name="state">A user object that can be tracked through the returned result</param>  
![InBlock.gif][]        /// <param name="async">Whether to run async, or try on current thread if invoke is not required.</param>  
![InBlock.gif][]        /// <param name="getRetVal">If true, and the method/delgete returns something, it is included in the AsyncRes returned (after the method completes)</param>  
![InBlock.gif][]        /// <param name="rMode">If true, will make sure no other instances are running your method.</param>  
![InBlock.gif][]        /// <param name="c">A control to Invoke upon GUI thread of, if needed. Null if unused.</param>  
![ExpandedSubBlockEnd.gif][]        /// <returns>AsyncRes with all kind o' goodies for waiting, result values, etc.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public static AsyncRes UI(DlgR d, bool getRetVal, Control c, object state, bool async, ReenteranceMode rMode) ![dot.gif][]\{  
![InBlock.gif][]            return Do(d, null, getRetVal, state, false, rMode, c, async);  
![ExpandedSubBlockEnd.gif][]        \}  
![ExpandedSubBlockEnd.gif][]        \#endregion  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]  
![ContractedSubBlock.gif][]![ExpandedSubBlockStart.gif][]    AsyncRes class\#region AsyncRes class  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    /\*\*//// <summary>  
![InBlock.gif][]    /// Used with the Async helper class, This class is mostly a holder for a lot of tracking fields and properties, with a few things mandated by the IAsyncResult interface.  
![ExpandedSubBlockEnd.gif][]    /// </summary>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public class AsyncRes : IAsyncResult ![dot.gif][]\{  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        internal AsyncRes(object state, Delegate d, string key, ReenteranceMode rMode) ![dot.gif][]\{  
![InBlock.gif][]            this.state = state;  
![InBlock.gif][]            this.asyncDelegate = d;  
![InBlock.gif][]            this.key = key;  
![InBlock.gif][]            this.RMode = rMode;  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![InBlock.gif][]        internal ReenteranceMode RMode = ReenteranceMode.Allow;  
![InBlock.gif][]  
![InBlock.gif][]        internal Thread thread = null;  
![InBlock.gif][]  
![InBlock.gif][]        private string key = null;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public string Method ![dot.gif][]\{ get ![dot.gif][]\{ return key; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        private Delegate asyncDelegate = null;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public Delegate AsyncDelegate ![dot.gif][]\{ get ![dot.gif][]\{ return asyncDelegate; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal AsyncAction result = AsyncAction.Unknown;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public AsyncAction Result ![dot.gif][]\{ get ![dot.gif][]\{ return result; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal Control control = null;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public Control Control ![dot.gif][]\{ get ![dot.gif][]\{ return control; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal DateTime createTime = DateTime.Now;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public DateTime TimeCreated ![dot.gif][]\{ get ![dot.gif][]\{ return createTime; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal DateTime completeTime = DateTime.MinValue;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public DateTime TimeCompleted ![dot.gif][]\{ get ![dot.gif][]\{ return completeTime; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal DateTime startTime = DateTime.Now;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public DateTime TimeStarted ![dot.gif][]\{ get ![dot.gif][]\{ return startTime; \} \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public TimeSpan TimeElapsed ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            get ![dot.gif][]\{ return ((completeTime > DateTime.MinValue) ? completeTime : DateTime.Now) \- createTime; \}  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public TimeSpan TimeRunning ![dot.gif][]\{  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            get ![dot.gif][]\{ return (startTime == DateTime.MinValue) ? TimeSpan.Zero : ((completeTime > DateTime.MinValue) ? completeTime : DateTime.Now) \- startTime;\}  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![InBlock.gif][]        internal object retVal = null;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public object ReturnValue ![dot.gif][]\{ get ![dot.gif][]\{ return retVal; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal bool isStarted = false;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public bool IsStarted ![dot.gif][]\{ get ![dot.gif][]\{ return isStarted; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        private object state = null;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public object AsyncState ![dot.gif][]\{ get ![dot.gif][]\{ return state; \} \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        /\*\*//// <summary>  
![InBlock.gif][]        /// Aborts a running associated thread.  If possible it will cancel if not yet started  
![InBlock.gif][]        /// </summary>  
![ExpandedSubBlockEnd.gif][]        /// <returns>True if the thread could be cancelled before it started.</returns>  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public bool CancelOrAbort() ![dot.gif][]\{  
![InBlock.gif][]            isCompleted = true;  
![InBlock.gif][]            if (!isStarted) return true;//cancelled  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]            if (thread != null && thread.IsAlive) ![dot.gif][]\{  
![InBlock.gif][]                thread.Abort();  
![ExpandedSubBlockEnd.gif][]            \}  
![InBlock.gif][]  
![InBlock.gif][]            return false;  
![ExpandedSubBlockEnd.gif][]        \}  
![InBlock.gif][]  
![InBlock.gif][]        internal ManualResetEvent mre = new ManualResetEvent(false);  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public WaitHandle AsyncWaitHandle ![dot.gif][]\{ get ![dot.gif][]\{ return mre; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal bool completedSynchronously = false;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public bool CompletedSynchronously ![dot.gif][]\{ get ![dot.gif][]\{ return completedSynchronously; \} \}  
![InBlock.gif][]  
![InBlock.gif][]        internal bool isCompleted = false;  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]        public bool IsCompleted ![dot.gif][]\{ get ![dot.gif][]\{ return isCompleted; \} \}  
![ExpandedSubBlockEnd.gif][]    \}  
![ExpandedSubBlockEnd.gif][]    \#endregion  
![InBlock.gif][]  
![ContractedSubBlock.gif][]![ExpandedSubBlockStart.gif][]    Definitions of enums and delegates\#region Definitions of enums and delegates  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    /\*\*//// <summary>  
![InBlock.gif][]    /// Abreviated Empty Delegate for use in anonymous casting  
![ExpandedSubBlockEnd.gif][]    /// </summary>  
![InBlock.gif][]    public delegate void Dlg();  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    /\*\*//// <summary>  
![InBlock.gif][]    /// Abreviated Empty Delegate for use in anonymous methods when a return is needed  
![InBlock.gif][]    /// </summary>  
![ExpandedSubBlockEnd.gif][]    /// <returns>Umm, anything you want.</returns>  
![InBlock.gif][]    public delegate object DlgR();  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public enum AsyncAction ![dot.gif][]\{  
![InBlock.gif][]        Unknown = 0,  
![InBlock.gif][]        ThreadPool = 1,  
![InBlock.gif][]        Thread = 2,  
![InBlock.gif][]        Failed = 4,  
![InBlock.gif][]        Reenterant = 8,  
![InBlock.gif][]        ControlInvoked = 16  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public enum ReenteranceMode ![dot.gif][]\{  
![InBlock.gif][]        Allow = 1,  
![InBlock.gif][]        Bypass = 2,  
![InBlock.gif][]        Stack = 4,  
![ExpandedSubBlockEnd.gif][]    \}  
![ExpandedSubBlockEnd.gif][]    \#endregion  
![ExpandedBlockEnd.gif][]\}  
![None.gif][]

异步获取控件值：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][] Code   
![None.gif][]AsyncRes result = Async.UI(  
![None.gif][]    //make sure the delegate/method returns a value:  
![ExpandedBlockStart.gif][]![ContractedBlock.gif][]    delegate ![dot.gif][]\{ return textBox1.Text; \},  
![None.gif][]    true, //yes, we want to get the return value  
![None.gif][]    myForm, //the control to invoke on  
![None.gif][]    null, //the state object, we don't need to track anything.  
![None.gif][]    true, //invoke asynchronously?  
![None.gif][]    ReenteranceMode.Allow); //don't worry about thread safety in this case.  
![None.gif][]  
![None.gif][]// ![dot.gif][]. do other things ![dot.gif][] //  
![None.gif][]  
![None.gif][]// now make sure the task above has completed..   
![None.gif][]result.AsyncWaitHandle.WaitOne();  
![None.gif][]  
![None.gif][]//and use the value  
![None.gif][]Console.WriteLine("The textbox says: " \+ result.ReturnValue);  
![None.gif][]  
![None.gif][]

同步设置控件值：

![ContractedBlock.gif][] ![ExpandedBlockStart.gif][] Code   
Async.UI(delegate \{ textBox1.Text = "This is way easier!"; \}, textBox1, true);

转载于:https://www.cnblogs.com/perfectdesign/archive/2009/03/02/1401569.html

[ContractedBlock.gif]: https://www.cnblogs.com/Images/OutliningIndicators/ContractedBlock.gif
[ExpandedBlockStart.gif]: /images/20211220/b7519a590218452d9278ac9a9bf188e6.png
[None.gif]: /images/20211220/7dfdd6db30604fe5af4ec30aaa7002a5.png
[dot.gif]: /images/20211220/03f01bd240944772b9cbd43be6d40189.png
[ExpandedSubBlockStart.gif]: /images/20211220/dc8f59306e42411aadfd40a96a7fdf5d.png
[ContractedSubBlock.gif]: /images/20211220/29e2853075124315b906afc213aabb14.png
[InBlock.gif]: /images/20211220/b412a7c8aef441f5b5402467886afd5a.png
[ExpandedSubBlockEnd.gif]: /images/20211220/2f15c50ce61a4a488cd80368fd295485.png
[ExpandedBlockEnd.gif]: /images/20211220/7ce4ed1817d844e88a239fd0e1795385.png