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>()

來源:

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)

來源:

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)

來源:

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

服務的端點，可讓用戶端尋找並與服務通訊。