Nasıl yapılır: WCF Hizmeti İşlemlerini Zaman Uyumsuz Olarak Çağırma

Bu makale, istemcinin zaman uyumsuz olarak bir hizmet işlemine nasıl erişebileceğini kapsar. Bu makaledeki hizmet arabirimini ICalculator uygular. İstemci, olay temelli zaman uyumsuz çağrı modelini kullanarak bu arabirimdeki işlemleri zaman uyumsuz olarak çağırabilir. (Olay tabanlı zaman uyumsuz çağrı modeli hakkında daha fazla bilgi için bkz. Olay Tabanlı Zaman Uyumsuz Desen ile Çok İş Parçacıklı Programlama). Bir hizmette bir işlemin zaman uyumsuz olarak nasıl uygulandığını gösteren bir örnek için bkz . Nasıl yapılır: Zaman Uyumsuz Hizmet İşlemi Uygulama. Zaman uyumlu ve zaman uyumsuz işlemler hakkında daha fazla bilgi için bkz . Zaman Uyumlu ve Zaman Uyumsuz İşlemler.

Yordam

WCF hizmet işlemlerini zaman uyumsuz olarak çağırmak için

1. ServiceModel Meta Veri Yardımcı Programı Aracı (Svcutil.exe) aracını, aşağıdaki komutta gösterildiği gibi hem hem de /async /tcv:Version35 komut seçenekleriyle birlikte çalıştırın.

   svcutil /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples http://localhost:8000/servicemodelsamples/service/mex /a /tcv:Version35
   

   Bu, zaman uyumlu ve standart temsilci tabanlı zaman uyumsuz işlemlere ek olarak şunları içeren bir WCF istemci sınıfı oluşturur:

   • Olay tabanlı zaman uyumsuz çağrı yaklaşımıyla kullanılmak üzere iki <operationName>``Async işlem. Örneğin:

     public void AddAsync(double n1, double n2)
     {
         this.AddAsync(n1, n2, null);
     }
     
     public void AddAsync(double n1, double n2, object userState)
     {
         if ((this.onBeginAddDelegate == null))
         {
             this.onBeginAddDelegate = new BeginOperationDelegate(this.OnBeginAdd);
         }
         if ((this.onEndAddDelegate == null))
         {
             this.onEndAddDelegate = new EndOperationDelegate(this.OnEndAdd);
         }
         if ((this.onAddCompletedDelegate == null))
         {
             this.onAddCompletedDelegate = new System.Threading.SendOrPostCallback(this.OnAddCompleted);
         }
         base.InvokeAsync(this.onBeginAddDelegate, new object[] {
                     n1,
                     n2}, this.onEndAddDelegate, this.onAddCompletedDelegate, userState);
     }
     

     Public Overloads Sub AddAsync(ByVal n1 As Double, ByVal n2 As Double)
         Me.AddAsync(n1, n2, Nothing)
     End Sub
     
     Public Overloads Sub AddAsync(ByVal n1 As Double, ByVal n2 As Double, ByVal userState As Object)
         If (Me.onBeginAddDelegate Is Nothing) Then
             Me.onBeginAddDelegate = AddressOf Me.OnBeginAdd
         End If
         If (Me.onEndAddDelegate Is Nothing) Then
             Me.onEndAddDelegate = AddressOf Me.OnEndAdd
         End If
         If (Me.onAddCompletedDelegate Is Nothing) Then
             Me.onAddCompletedDelegate = AddressOf Me.OnAddCompleted
         End If
         MyBase.InvokeAsync(Me.onBeginAddDelegate, New Object() {n1, n2}, Me.onEndAddDelegate, Me.onAddCompletedDelegate, userState)
     End Sub
     

   • Olay tabanlı zaman uyumsuz çağrı yaklaşımıyla kullanılmak üzere formun <operationName>``Completed işlem tamamlandı olayları. Örneğin:

     public event System.EventHandler<AddCompletedEventArgs> AddCompleted;
     

     Public Event AddCompleted As System.EventHandler(Of AddCompletedEventArgs)
     

   • System.EventArgs türleri, olay tabanlı zaman uyumsuz çağrı yaklaşımıyla kullanılmak üzere her işlemin (formdaki <operationName>``CompletedEventArgs) türleridir. Örneğin:

     [System.Diagnostics.DebuggerStepThroughAttribute()]
     [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]
     public partial class AddCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
     {
         private object[] results;
     
         public AddCompletedEventArgs(object[] results, System.Exception exception, bool cancelled, object userState) :
                 base(exception, cancelled, userState)
         {       this.results = results;         }
     
         public double Result
         {
             get            {
                 base.RaiseExceptionIfNecessary();
                 return ((double)(this.results[0]));
             }
         }
     }
     

     <System.Diagnostics.DebuggerStepThroughAttribute(),  _
      System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")>  _
     Partial Public Class AddCompletedEventArgs
         Inherits System.ComponentModel.AsyncCompletedEventArgs
         
         Private results() As Object
         
         Public Sub New(ByVal results() As Object, ByVal exception As System.Exception, ByVal cancelled As Boolean, ByVal userState As Object)
             MyBase.New(exception, cancelled, userState)
             Me.results = results
         End Sub
         
         Public ReadOnly Property Result() As Double
             Get
                 MyBase.RaiseExceptionIfNecessary
                 Return CType(Me.results(0),Double)
             End Get
         End Property
     End Class
     

2. Çağıran uygulamada, aşağıdaki örnek kodda gösterildiği gibi zaman uyumsuz işlem tamamlandığında çağrılması için bir geri çağırma yöntemi oluşturun.

   // Asynchronous callbacks for displaying results.
   static void AddCallback(object sender, AddCompletedEventArgs e)
   {
       Console.WriteLine("Add Result: {0}", e.Result);
   }
   

   ' Asynchronous callbacks for displaying results.
   Private Shared Sub AddCallback(ByVal sender As Object, ByVal e As AddCompletedEventArgs)
   
       Console.WriteLine("Add Result: {0}", e.Result)
   
   End Sub
   

3. İşlemi çağırmadan önce, işleyici yöntemini (önceki adımda oluşturulan) <operationName>``Completed olaya eklemek için yeni bir tür <operationName>``EventArgs geneli System.EventHandler<TEventArgs> kullanın. Ardından yöntemini çağırın <operationName>``Async . Örneğin:

   // AddAsync
   double value1 = 100.00D;
   double value2 = 15.99D;
   client.AddCompleted += new EventHandler<AddCompletedEventArgs>(AddCallback);
   client.AddAsync(value1, value2);
   Console.WriteLine("Add({0},{1})", value1, value2);
   

   ' AddAsync
   Dim value1 As Double = 100
   Dim value2 As Double = 15.99
   AddHandler client.AddCompleted, AddressOf AddCallback
   client.AddAsync(value1, value2)
   Console.WriteLine("Add({0},{1})", value1, value2)
   

Örnek

using System;

namespace Microsoft.ServiceModel.Samples
{
    // The service contract is defined in generatedClient.cs, generated from the service by the svcutil tool.

    class Client
    {
        static void Main()
        {
            Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.");
            Console.WriteLine();

            // Create a client
            CalculatorClient client = new CalculatorClient();

            // AddAsync
            double value1 = 100.00D;
            double value2 = 15.99D;
            client.AddCompleted += new EventHandler<AddCompletedEventArgs>(AddCallback);
            client.AddAsync(value1, value2);
            Console.WriteLine("Add({0},{1})", value1, value2);

            // SubtractAsync
            value1 = 145.00D;
            value2 = 76.54D;
            client.SubtractCompleted += new EventHandler<SubtractCompletedEventArgs>(SubtractCallback);
            client.SubtractAsync(value1, value2);
            Console.WriteLine("Subtract({0},{1})", value1, value2);

            // Multiply
            value1 = 9.00D;
            value2 = 81.25D;
            double result = client.Multiply(value1, value2);
            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

            // Divide
            value1 = 22.00D;
            value2 = 7.00D;
            result = client.Divide(value1, value2);
            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

            Console.ReadLine();

            //Closing the client gracefully closes the connection and cleans up resources
            client.Close();
        }

        // Asynchronous callbacks for displaying results.
        static void AddCallback(object sender, AddCompletedEventArgs e)
        {
            Console.WriteLine("Add Result: {0}", e.Result);
        }

        static void SubtractCallback(object sender, SubtractCompletedEventArgs e)
        {
            Console.WriteLine("Subtract Result: {0}", e.Result);
        }
    }
}

Namespace Microsoft.ServiceModel.Samples

    ' The service contract is defined in generatedClient.vb, generated from the service by the svcutil tool.

    Class Client

        Public Shared Sub Main()

            Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.")
            Console.WriteLine()

            ' Create a client
            Dim client As New CalculatorClient()

            ' AddAsync
            Dim value1 As Double = 100
            Dim value2 As Double = 15.99
            AddHandler client.AddCompleted, AddressOf AddCallback
            client.AddAsync(value1, value2)
            Console.WriteLine("Add({0},{1})", value1, value2)

            ' SubtractAsync
            value1 = 145
            value2 = 76.54
            AddHandler client.SubtractCompleted, AddressOf SubtractCallback
            client.SubtractAsync(value1, value2)
            Console.WriteLine("Subtract({0},{1})", value1, value2)

            ' Multiply
            value1 = 9
            value2 = 81.25
            Dim result As Double = client.Multiply(value1, value2)
            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)

            ' Divide
            value1 = 22
            value2 = 7
            result = client.Divide(value1, value2)
            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)
            Console.ReadLine()

            'Closing the client gracefully closes the connection and cleans up resources
            client.Close()

        End Sub
        ' Asynchronous callbacks for displaying results.
        Private Shared Sub AddCallback(ByVal sender As Object, ByVal e As AddCompletedEventArgs)

            Console.WriteLine("Add Result: {0}", e.Result)

        End Sub
        Private Shared Sub SubtractCallback(ByVal sender As Object, ByVal e As SubtractCompletedEventArgs)

            Console.WriteLine("Subtract Result: {0}", e.Result)

        End Sub

    End Class

End Namespace

Ayrıca bkz.

• Nasıl yapılır: Zaman Uyumsuz Bir Hizmet İşlemi Uygulama