ClientBase<TChannel> Costruttori

Definizione

Spazio dei nomi:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v8.0.0

Inizializza una nuova istanza della classe ClientBase<TChannel>.

Overload

ClientBase<TChannel>()	Inizializza una nuova istanza della classe ClientBase<TChannel> utilizzando l'endpoint di destinazione predefinito del file di configurazione dell'applicazione.
ClientBase<TChannel>(Binding, EndpointAddress)	Inizializza una nuova istanza della classe ClientBase<TChannel> utilizzando l'associazione e l'indirizzo endpoint specificati.
ClientBase<TChannel>(ServiceEndpoint)	Inizializza una nuova istanza della classe ClientBase<TChannel> usando il ServiceEndpoint specificato.

Commenti

Usare per creare un oggetto client WCF dalle informazioni sull'endpoint nel file di configurazione dell'applicazione. La funzione principale del costruttore è quella di creare una classe System.ServiceModel.ChannelFactory<TChannel> in cui il parametro di tipo è il tipo del contratto di servizio di destinazione.

ClientBase<TChannel>()

Origine:

ClientBase.cs

Inizializza una nuova istanza della classe ClientBase<TChannel> utilizzando l'endpoint di destinazione predefinito del file di configurazione dell'applicazione.

protected:
 ClientBase();

protected ClientBase ();

Protected Sub New ()

Eccezioni

InvalidOperationException

Nel file di configurazione non sono presenti informazioni sull'endpoint predefinito o è presente più di un endpoint oppure non esiste alcun file di configurazione.

Esempio

Nell'esempio di codice seguente viene illustrato come un client utilizza questo costruttore in una classe SampleServiceClient che estende la classe 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

Commenti

Usare questo costruttore per creare un oggetto client WCF per richiamare un servizio. Il costruttore utilizza il parametro di tipo come contratto di destinazione e le informazioni sull'associazione e sull'indirizzo del file di configurazione dell'applicazione.

ClientBase<TChannel>(Binding, EndpointAddress)

Origine:

ClientBase.cs

Inizializza una nuova istanza della classe ClientBase<TChannel> utilizzando l'associazione e l'indirizzo endpoint specificati.

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)

Parametri

binding

Binding

Associazione da utilizzare per le chiamate al servizio.

remoteAddress

EndpointAddress

L'indirizzo dell'endpoint del servizio.

Eccezioni

ArgumentNullException

binding o remoteAddress è null.

ClientBase<TChannel>(ServiceEndpoint)

Origine:

ClientBase.cs

Inizializza una nuova istanza della classe ClientBase<TChannel> usando il ServiceEndpoint specificato.

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)

Parametri

endpoint

ServiceEndpoint

Endpoint per un servizio che consente ai client di individuare e comunicare con il servizio.