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

Конечная точка для службы, которая позволяет клиентам выполнять поиск и обмен данными со службой.