संक्षेप में: .NET में Async / Await बेस्ट प्रैक्टिस

Async / Await - परिचय

स्टेट मशीन (IAsyncStateMachine)

using System.Diagnostics;

namespace AsyncAwait
{
    public class AsyncAwait
    {

        public async Task AsyncAwaitExample()
        {
            int myVariable = 0;

            await DummyAsyncMethod();
            Debug.WriteLine("Continuation - After First Await");
            myVariable = 1;

            await DummyAsyncMethod();
            Debug.WriteLine("Continuation - After Second Await");
            myVariable = 2;

        }

        public async Task DummyAsyncMethod()
        {
            // 
        }

    }
}

Async / Await का उपयोग कब करें

• I / O संबंधित कार्य : आपका कोड कुछ अपेक्षा करेगा, जैसे डेटाबेस से डेटा, फ़ाइल पढ़ना, वेब सेवा कॉल करना। इस स्थिति में, आपको Async / Await का उपयोग करना चाहिए, न कि टास्क पैरेलल लाइब्रेरी का।
• सीपीयू संबंधित कार्य : आपका कोड जटिल गणना करेगा। इस स्थिति में, आपको Async / Await का उपयोग करना चाहिए, लेकिन आपको Task.Run का उपयोग करके किसी अन्य थ्रेड में काम शुरू करने की आवश्यकता है। आप टास्क पैरेलल लाइब्रेरी का उपयोग करने पर भी विचार कर सकते हैं ।

सभी तरह से Async करें

यदि विधि को async के रूप में घोषित किया गया है, तो सुनिश्चित करें कि प्रतीक्षा है!

Async शून्य से बचें

public async void AsyncVoidMethod()
{
    //!
}

public async Task AsyncTaskMethod()
{
    //!
}

• Async शून्य विधि में फेंके गए अपवाद इस विधि के बाहर नहीं पकड़े जा सकते हैं :

public async void AsyncVoidMethodThrowsException()
{
    throw new Exception("Hmmm, something went wrong!");
}

public void ThisWillNotCatchTheException()
{
    try
    {
        AsyncVoidMethodThrowsException();
    }
    catch(Exception ex)
    {
        //     
        Debug.WriteLine(ex.Message);
    }
}

public async Task AsyncTaskMethodThrowsException()
{
    throw new Exception("Hmmm, something went wrong!");
}

public async Task ThisWillCatchTheException()
{
    try
    {
        await AsyncTaskMethodThrowsException();
    }
    catch (Exception ex)
    {
        //    
        Debug.WriteLine(ex.Message);
    }
}

• Async शून्य तरीकों अवांछित दुष्प्रभाव हो सकते हैं, तो फोन करने वाले उन्हें अतुल्यकालिक होने की उम्मीद नहीं है : यदि आपके अतुल्यकालिक विधि रिटर्न कुछ भी नहीं, (बिना एक "टास्क async उपयोग <टी >टास्क के लिए") वापसी प्रकार के रूप में।
• Async शून्य विधियों का परीक्षण करना बहुत कठिन है : त्रुटि हैंडलिंग और लेआउट में अंतर के कारण, इकाई परीक्षण लिखना मुश्किल है जो async शून्य विधियों को कहते हैं। एसिंक्रोनस MSTest परीक्षण केवल एसिंक्रोनस विधियों के लिए काम करता है जो कार्य या कार्य <T लौटाते हैं >।

रिटर्न प्रतीक्षा के बजाय रिटर्न टास्क को प्राथमिकता दें

public async Task<string> AsyncTask()

{
   //  !
   //...  -  
   //await -   ,  await  

   return await GetData();

}

public Task<string> JustTask()

{
   //!
   //...  -  
   // Task

   return GetData();

}

कोशिश के अंदर रिटर्न टास्क को न लपेटें..चुनें {} या {} ब्लॉकों का उपयोग करें

public Task<string> ReturnTaskExceptionNotCaught()

{
   try
   {
       // ...

       return GetData();

   }
   catch (Exception ex)

   {
       //     

       Debug.WriteLine(ex.Message);
       throw;
   }

}

public Task<string> ReturnTaskUsingProblem()

{
   using (var resource = GetResource())
   {

       // ...  ,     , ,    

       return GetData(resource);
   }
}

इसके बजाय उपयोग .Wait()या .Resultउपयोग करने से बचेंGetAwaiter().GetResult()

public void GetAwaiterGetResultExample()

{
   // ,    ,     AggregateException  

   string data = GetData().Result;

   // ,   ,      

   data = GetData().GetAwaiter().GetResult();
}

यदि विधि अतुल्यकालिक है, तो उसके नाम में Async प्रत्यय जोड़ें

अतुल्यकालिक लाइब्रेरी विधियों को प्रदर्शन में सुधार करने के लिए टास्क.ऑनफॉगर एवाइट (गलत) का उपयोग करना चाहिए

public async Task ConfigureAwaitExample()

{
   //   ConfigureAwait(false)   .

   var data = await GetData().ConfigureAwait(false);
}

अतुल्यकालिक कार्य प्रगति रिपोर्ट

एसिंक्रोनस कार्य रद्द करें

1. कॉल करने वाला एक रद्दीकरण TokenSource ऑब्जेक्ट बनाता है।
2. कॉलर रद्द किए गए एसिंक्रोनस API को कॉल करता है और रद्द करने के लिए रद्द करता है रद्द करेंसेवा रद्द करेंसेनोटलोकेशनसेनकोर्स (CancellationTokenSource.Token)।
3. कॉल करने वाला रद्द करने के लिए रद्द करने का अनुरोध करता है, कैंसेलेशनटोकनसे सोर्स (कैंसेलेशनटॉकेनसोर्स.कैंसेल ()) ऑब्जेक्ट का उपयोग करके।
4. कार्य रद्द करने और रद्द करने की पुष्टि करता है, आमतौर पर कैंसेलेशनटोकन का उपयोग करता है। TrowIfCancellationRequested विधि।

प्रगति और निरस्तीकरण रिपोर्ट - उदाहरण

using System;
using System.Threading.Tasks;
using System.Windows.Forms;
using System.Threading;
namespace TestAsyncAwait
{
   public partial class AsyncProgressCancelExampleForm : Form
   {
       public AsyncProgressCancelExampleForm()
       {
           InitializeComponent();
       }

       CancellationTokenSource _cts = new CancellationTokenSource();

       private async void btnRunAsync_Click(object sender, EventArgs e)

       {

           //   .

            <int>   ,          ,   ,    , ETA  . .

           var progressIndicator = new Progress<int>(ReportProgress);

           try

           {
               //   ,         

               await AsyncMethod(progressIndicator, _cts.Token);

           }

           catch (OperationCanceledException ex)

           {
               // 

               lblProgress.Text = "Cancelled";
           }
       }

       private void btnCancel_Click(object sender, EventArgs e)

       {
          // 
           _cts.Cancel();

       }

       private void ReportProgress(int value)

       {
           //    

           lblProgress.Text = value.ToString();

       }

       private async Task AsyncMethod(IProgress<int> progress, CancellationToken ct)

       {

           for (int i = 0; i < 100; i++)

           {
              //   ,     

               await Task.Delay(1000);

               //   

               if (ct != null)

               {

                   ct.ThrowIfCancellationRequested();

               }

               //   

               if (progress != null)

               {

                   progress.Report(i);
               }
           }
       }
   }
}

समय की प्रतीक्षा की जा रही है

कई अतुल्यकालिक कार्यों के पूरा होने की प्रतीक्षा कर रहा है