ClientBase<TChannel> Constructors

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.1.0

Initializes a new instance of the ClientBase<TChannel> class.

Overloads

ClientBase<TChannel>()	Initializes a new instance of the ClientBase<TChannel> class using the default target endpoint from the application configuration file.
ClientBase<TChannel>(Binding, EndpointAddress)	Initializes a new instance of the ClientBase<TChannel> class using the specified binding and target address.
ClientBase<TChannel>(ServiceEndpoint)	Initializes a new instance of the ClientBase<TChannel> class using the specified ServiceEndpoint.

Remarks

Use to create a WCF client object from the endpoint information in the application configuration file. The main function of the constructor is to create a System.ServiceModel.ChannelFactory<TChannel> where the type parameter is the type of the target service contract.

ClientBase<TChannel>()

Source:

ClientBase.cs

Initializes a new instance of the ClientBase<TChannel> class using the default target endpoint from the application configuration file.

protected:
 ClientBase();

protected ClientBase ();

Protected Sub New ()

Exceptions

InvalidOperationException

Either there is no default endpoint information in the configuration file, more than one endpoint in the file, or no configuration file.

Examples

The following code example shows how a client uses this constructor in a SampleServiceClient class that extends the ClientBase<TChannel> class.

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

Remarks

Use this constructor to create a WCF client object to invoke a service. This constructor uses the type parameter as the target contract and the binding and address information from the application configuration file.

ClientBase<TChannel>(Binding, EndpointAddress)

Source:

ClientBase.cs

Initializes a new instance of the ClientBase<TChannel> class using the specified binding and target address.

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)

Parameters

binding

Binding

The binding with which to make calls to the service.

remoteAddress

EndpointAddress

The address of the service endpoint.

Exceptions

ArgumentNullException

binding or remoteAddress is null.

ClientBase<TChannel>(ServiceEndpoint)

Source:

ClientBase.cs

Initializes a new instance of the ClientBase<TChannel> class using the specified 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)

Parameters

endpoint

ServiceEndpoint

The endpoint for a service that allows clients to find and communicate with the service.