ClientBase<TChannel> Oluşturucular

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

ClientBase<TChannel> sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

ClientBase<TChannel>()	Uygulama yapılandırma dosyasından ClientBase<TChannel> varsayılan hedef uç noktayı kullanarak sınıfının yeni bir örneğini başlatır.
ClientBase<TChannel>(Binding, EndpointAddress)	Belirtilen bağlamayı ve hedef adresi kullanarak sınıfın yeni bir örneğini ClientBase<TChannel> başlatır.
ClientBase<TChannel>(ServiceEndpoint)	Belirtilen ServiceEndpointöğesini kullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır.

Açıklamalar

Uygulama yapılandırma dosyasındaki uç nokta bilgilerinden bir WCF istemci nesnesi oluşturmak için kullanın. Oluşturucunun ana işlevi, type parametresinin hedef hizmet sözleşmesinin türü olduğu bir System.ServiceModel.ChannelFactory<TChannel> oluşturmaktır.

ClientBase<TChannel>()

Kaynak:

ClientBase.cs

Uygulama yapılandırma dosyasından ClientBase<TChannel> varsayılan hedef uç noktayı kullanarak sınıfının yeni bir örneğini başlatır.

protected:
 ClientBase();

protected ClientBase ();

Protected Sub New ()

Özel durumlar

InvalidOperationException

Yapılandırma dosyasında varsayılan uç nokta bilgisi yok, dosyada birden fazla uç nokta veya yapılandırma dosyası yok.

Örnekler

Aşağıdaki kod örneği, bir istemcinin sınıfını genişleten bir SampleServiceClient sınıfta bu oluşturucuyu ClientBase<TChannel> nasıl kullandığını gösterir.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;

public class Client
{
  public static void Main()
  {
    // Picks up configuration from the config file.
    SampleServiceClient wcfClient = new SampleServiceClient();
    try
    {
        // Making calls.
        Console.WriteLine("Enter the greeting to send: ");
        string greeting = Console.ReadLine();
        Console.WriteLine("The service responded: " + wcfClient.SampleMethod(greeting));

        Console.WriteLine("Press ENTER to exit:");
        Console.ReadLine();

        // Done with service.
        wcfClient.Close();
        Console.WriteLine("Done!");
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      wcfClient.Abort();
      Console.Read();
    }
    catch(CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message);
      wcfClient.Abort();
      Console.Read();
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels

Public Class Client
  Public Shared Sub Main()
    ' Picks up configuration from the config file.
    Dim wcfClient As New SampleServiceClient()
    Try
        ' Making calls.
        Console.WriteLine("Enter the greeting to send: ")
            Dim greeting = Console.ReadLine()
        Console.WriteLine("The service responded: " & wcfClient.SampleMethod(greeting))

        Console.WriteLine("Press ENTER to exit:")
        Console.ReadLine()

        ' Done with service. 
        wcfClient.Close()
        Console.WriteLine("Done!")
    Catch timeProblem As TimeoutException
      Console.WriteLine("The service operation timed out. " & timeProblem.Message)
      wcfClient.Abort()
      Console.Read()
    Catch commProblem As CommunicationException
      Console.WriteLine("There was a communication problem. " & commProblem.Message)
      wcfClient.Abort()
      Console.Read()
    End Try
  End Sub
End Class

Açıklamalar

Bir hizmeti çağırmak üzere bir WCF istemci nesnesi oluşturmak için bu oluşturucuyu kullanın. Bu oluşturucu, hedef sözleşme olarak type parametresini ve uygulama yapılandırma dosyasındaki bağlama ve adres bilgilerini kullanır.

ClientBase<TChannel>(Binding, EndpointAddress)

Kaynak:

ClientBase.cs

Belirtilen bağlamayı ve hedef adresi kullanarak sınıfın yeni bir örneğini ClientBase<TChannel> başlatır.

protected:
 ClientBase(System::ServiceModel::Channels::Binding ^ binding, System::ServiceModel::EndpointAddress ^ remoteAddress);

protected ClientBase (System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress);

new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.Channels.Binding * System.ServiceModel.EndpointAddress -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>

Protected Sub New (binding As Binding, remoteAddress As EndpointAddress)

Parametreler

binding

Binding

Hizmete çağrı yapmak için bağlama.

remoteAddress

EndpointAddress

Hizmet uç noktasının adresi.

Özel durumlar

ArgumentNullException

binding veya remoteAddress şeklindedir null.

ClientBase<TChannel>(ServiceEndpoint)

Kaynak:

ClientBase.cs

Belirtilen ServiceEndpointöğesini kullanarak sınıfının yeni bir örneğini ClientBase<TChannel> başlatır.

protected:
 ClientBase(System::ServiceModel::Description::ServiceEndpoint ^ endpoint);

protected ClientBase (System.ServiceModel.Description.ServiceEndpoint endpoint);

new System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)> : System.ServiceModel.Description.ServiceEndpoint -> System.ServiceModel.ClientBase<'Channel (requires 'Channel : null)>

Protected Sub New (endpoint As ServiceEndpoint)

Parametreler

endpoint

ServiceEndpoint

İstemcilerin hizmeti bulmasını ve hizmetle iletişim kurmasını sağlayan hizmetin uç noktası.