ClientBase<TChannel> 构造函数

定义

命名空间:

System.ServiceModel

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v8.0.0

初始化 ClientBase<TChannel> 类的新实例。

重载

ClientBase<TChannel>()	使用应用程序配置文件中的默认目标终结点初始化 ClientBase<TChannel> 类的新实例。
ClientBase<TChannel>(Binding, EndpointAddress)	使用指定的绑定和目标地址初始化 ClientBase<TChannel> 类的新实例。
ClientBase<TChannel>(ServiceEndpoint)	使用指定的 ClientBase<TChannel> 初始化 ServiceEndpoint 类的新实例。

注解

使用 根据应用程序配置文件中的终结点信息创建 WCF 客户端对象。 该构造函数的主要功能是创建 System.ServiceModel.ChannelFactory<TChannel>，其中类型参数为目标服务协定的类型。

ClientBase<TChannel>()

Source:

ClientBase.cs

使用应用程序配置文件中的默认目标终结点初始化 ClientBase<TChannel> 类的新实例。

protected:
 ClientBase();

protected ClientBase ();

Protected Sub New ()

例外

InvalidOperationException

配置文件中没有默认的终结点信息，或者文件中有多个终结点，或者没有配置文件。

示例

下面的代码示例演示客户端如何在扩展 SampleServiceClient 类的 ClientBase<TChannel> 类中使用此构造函数。

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

注解

使用此构造函数创建 WCF 客户端对象来调用服务。 此构造函数使用类型参数（目标协定的类型）和应用程序配置文件中的绑定和地址信息。

ClientBase<TChannel>(Binding, EndpointAddress)

Source:

ClientBase.cs

使用指定的绑定和目标地址初始化 ClientBase<TChannel> 类的新实例。

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)

参数

binding

Binding

用于调用服务的绑定。

remoteAddress

EndpointAddress

服务终结点的地址。

例外

ArgumentNullException

binding 或 remoteAddress 为 null。

ClientBase<TChannel>(ServiceEndpoint)

Source:

ClientBase.cs

使用指定的 ClientBase<TChannel> 初始化 ServiceEndpoint 类的新实例。

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)

参数

endpoint

ServiceEndpoint

允许客户端查找并与服务通信的服务的终结点。