WebChannelFactory<TChannel> Construtores

Referência

Definição

Namespace:: System.ServiceModel.Web

Assembly:: System.ServiceModel.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe WebChannelFactory<TChannel>.

Sobrecargas

WebChannelFactory<TChannel>()	Inicializa uma nova instância da classe WebChannelFactory<TChannel>.
WebChannelFactory<TChannel>(Binding)	Inicializa uma nova instância da classe WebChannelFactory<TChannel>.
WebChannelFactory<TChannel>(ServiceEndpoint)	Inicializa uma nova instância da classe WebChannelFactory<TChannel>.
WebChannelFactory<TChannel>(String)	Inicializa uma nova instância da classe WebChannelFactory<TChannel>.
WebChannelFactory<TChannel>(Type)	Inicializa uma nova instância da classe WebChannelFactory<TChannel>.
WebChannelFactory<TChannel>(Uri)	Inicializa uma nova instância da classe WebChannelFactory<TChannel> com o Uri especificado.
WebChannelFactory<TChannel>(Binding, Uri)	Inicializa uma nova instância da classe WebChannelFactory<TChannel> com a associação e o Uri especificados.
WebChannelFactory<TChannel>(String, Uri)	Inicializa uma nova instância da classe WebChannelFactory<TChannel> com a configuração de ponto de extremidade e o Uri especificados.

WebChannelFactory<TChannel>()

Inicializa uma nova instância da classe WebChannelFactory<TChannel>.

public:
 WebChannelFactory();

public WebChannelFactory ();

Public Sub New ()

Aplica-se a

WebChannelFactory<TChannel>(Binding)

Inicializa uma nova instância da classe WebChannelFactory<TChannel>.

public:
 WebChannelFactory(System::ServiceModel::Channels::Binding ^ binding);

public WebChannelFactory (System.ServiceModel.Channels.Binding binding);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : System.ServiceModel.Channels.Binding -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (binding As Binding)

Parâmetros

binding: Binding

A associação a ser usada ao criar o canal.

Exemplos

O código a seguir mostra como usar esse construtor para criar um WebChannelFactory<TChannel> e usá-lo para chamar um serviço WCF.

Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
    host.Open();
    WebHttpBinding binding = new WebHttpBinding();
    WebChannelFactory<IService> cf = new WebChannelFactory<IService>(binding);
    cf.Endpoint.Address = new EndpointAddress("http://localhost:8000");
    IService channel = cf.CreateChannel();
    string s;

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
    s = channel.EchoWithGet("Hello, world");
    Console.WriteLine("   Output: {0}", s);
}
catch (CommunicationException ex)
{
    Console.WriteLine("An exception occurred: " + ex.Message);
}

Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
    host.Open()
    Dim binding As New WebHttpBinding()
    Dim cf As New WebChannelFactory(Of IService)(binding)
    cf.Endpoint.Address = New EndpointAddress("http://localhost:8000")
    Dim channel As IService = cf.CreateChannel()
    Dim s As String

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
    s = channel.EchoWithGet("Hello, world")
    Console.WriteLine("   Output:  0}", s)
Catch ex As CommunicationException
    Console.WriteLine("An exception occurred: " + ex.Message)
End Try

Aplica-se a

WebChannelFactory<TChannel>(ServiceEndpoint)

Inicializa uma nova instância da classe WebChannelFactory<TChannel>.

public:
 WebChannelFactory(System::ServiceModel::Description::ServiceEndpoint ^ endpoint);

public WebChannelFactory (System.ServiceModel.Description.ServiceEndpoint endpoint);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : System.ServiceModel.Description.ServiceEndpoint -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (endpoint As ServiceEndpoint)

Parâmetros

endpoint: ServiceEndpoint

O ponto de extremidade a ser usado ao criar o canal.

Exemplos

O código a seguir mostra como usar esse construtor para criar um WebChannelFactory<TChannel> e usá-lo para chamar um serviço WCF.

Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
    host.Open();

    WebHttpBinding binding = new WebHttpBinding();
    ContractDescription desc = ContractDescription.GetContract(typeof(IService));
    EndpointAddress endpointAddress = new EndpointAddress("http://localhost:8000");
    ServiceEndpoint endpoint = new ServiceEndpoint(desc, binding, endpointAddress);

    WebChannelFactory<IService> cf = new WebChannelFactory<IService>(endpoint);
    IService channel = cf.CreateChannel();
    string s;

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
    s = channel.EchoWithGet("Hello, world");
    Console.WriteLine("   Output: {0}", s);
}
catch (CommunicationException ex)
{
    Console.WriteLine("An exception occurred: " + ex.Message);
}

Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
    host.Open()

    Dim binding As New WebHttpBinding()
    Dim desc As ContractDescription = ContractDescription.GetContract(GetType(IService))
    Dim endpointAddress As New EndpointAddress("http://localhost:8000")
    Dim endpoint As New ServiceEndpoint(desc, binding, endpointAddress)

    Dim cf As New WebChannelFactory(Of IService)(endpoint)
    Dim channel As IService = cf.CreateChannel()
    Dim s As String

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
    s = channel.EchoWithGet("Hello, world")
    Console.WriteLine("   Output:  0}", s)
Catch ex As CommunicationException
    Console.WriteLine("An exception occurred: " + ex.Message)
End Try

Aplica-se a

WebChannelFactory<TChannel>(String)

Inicializa uma nova instância da classe WebChannelFactory<TChannel>.

public:
 WebChannelFactory(System::String ^ endpointConfigurationName);

public WebChannelFactory (string endpointConfigurationName);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : string -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (endpointConfigurationName As String)

Parâmetros

endpointConfigurationName: String

O nome no arquivo de configuração de aplicativo em que o canal está configurado.

Exemplos

O código a seguir mostra como usar esse construtor para criar uma WebChannelFactory<TChannel> instância e usá-la para chamar um serviço WCF.

Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
    host.Open();

    // The endpoint name passed to the constructor must match an endpoint element
    // in the application configuration file
    WebChannelFactory<IService> cf = new WebChannelFactory<IService>("MyEndpoint");
    IService channel = cf.CreateChannel();
    string s;

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
    s = channel.EchoWithGet("Hello, world");
    Console.WriteLine("   Output: {0}", s);
}
catch (CommunicationException ex)
{
    Console.WriteLine("An exception occurred: " + ex.Message);
}

Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
    host.Open()

    ' The endpoint name passed to the constructor must match an endpoint element
    ' in the application configuration file
    Dim cf As New WebChannelFactory(Of IService)("MyEndpoint")
    Dim channel As IService = cf.CreateChannel()
    Dim s As String

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
    s = channel.EchoWithGet("Hello, world")
    Console.WriteLine("   Output:  0}", s)
Catch ex As CommunicationException
    Console.WriteLine("An exception occurred: " + ex.Message)
End Try

Comentários

O endpointConfigurationName parâmetro deve ser definido como o mesmo valor que o name atributo do <endpoint> elemento no arquivo de configuração do aplicativo.

Aplica-se a

WebChannelFactory<TChannel>(Type)

Inicializa uma nova instância da classe WebChannelFactory<TChannel>.

public:
 WebChannelFactory(Type ^ channelType);

public WebChannelFactory (Type channelType);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : Type -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (channelType As Type)

Parâmetros

channelType: Type

O tipo de canal a ser usado.

Comentários

O tipo passado para o parâmetro de tipo deve ser uma interface.

Aplica-se a

WebChannelFactory<TChannel>(Uri)

Inicializa uma nova instância da classe WebChannelFactory<TChannel> com o Uri especificado.

public:
 WebChannelFactory(Uri ^ remoteAddress);

public WebChannelFactory (Uri remoteAddress);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : Uri -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (remoteAddress As Uri)

Parâmetros

remoteAddress: Uri

O URI do serviço Web que é chamado.

Exemplos

O código a seguir mostra como usar esse construtor para criar uma WebChannelFactory<TChannel> instância e chamar um serviço.

Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
    host.Open();

    WebChannelFactory<IService> cf = new WebChannelFactory<IService>(new Uri("http://localhost:8000"));
    IService channel = cf.CreateChannel();
    string s;

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
    s = channel.EchoWithGet("Hello, world");
    Console.WriteLine("   Output: {0}", s);
}
catch (CommunicationException ex)
{
    Console.WriteLine("An exception occurred: " + ex.Message);
}

Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
    host.Open()

    Dim cf As New WebChannelFactory(Of IService)(New Uri("http://localhost:8000"))
    Dim channel As IService = cf.CreateChannel()
    Dim s As String

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
    s = channel.EchoWithGet("Hello, world")
    Console.WriteLine("   Output:  0}", s)
Catch ex As CommunicationException
    Console.WriteLine("An exception occurred: " + ex.Message)
End Try

Aplica-se a

WebChannelFactory<TChannel>(Binding, Uri)

Inicializa uma nova instância da classe WebChannelFactory<TChannel> com a associação e o Uri especificados.

public:
 WebChannelFactory(System::ServiceModel::Channels::Binding ^ binding, Uri ^ remoteAddress);

public WebChannelFactory (System.ServiceModel.Channels.Binding binding, Uri remoteAddress);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : System.ServiceModel.Channels.Binding * Uri -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (binding As Binding, remoteAddress As Uri)

Parâmetros

binding: Binding

A associação a ser usada.

remoteAddress: Uri

O URI do serviço Web que é chamado.

Exemplos

O código a seguir mostra como usar esse construtor para criar uma WebChannelFactory<TChannel> instância e chamar um serviço.

Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
    host.Open();

    WebHttpBinding binding = new WebHttpBinding();
    WebChannelFactory<IService> cf = new WebChannelFactory<IService>(binding, new Uri("http://localhost:8000"));
    IService channel = cf.CreateChannel();
    string s;

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
    s = channel.EchoWithGet("Hello, world");
    Console.WriteLine("   Output: {0}", s);
}
catch (CommunicationException ex)
{
    Console.WriteLine("An exception occurred: " + ex.Message);
}

Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
    host.Open()

    Dim binding As New WebHttpBinding()
    Dim cf As New WebChannelFactory(Of IService)(binding, New Uri("http://localhost:8000"))
    Dim channel As IService = cf.CreateChannel()
    Dim s As String

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
    s = channel.EchoWithGet("Hello, world")
    Console.WriteLine("   Output:  0}", s)
Catch ex As CommunicationException
    Console.WriteLine("An exception occurred: " + ex.Message)
End Try

Aplica-se a

WebChannelFactory<TChannel>(String, Uri)

Inicializa uma nova instância da classe WebChannelFactory<TChannel> com a configuração de ponto de extremidade e o Uri especificados.

public:
 WebChannelFactory(System::String ^ endpointConfigurationName, Uri ^ remoteAddress);

public WebChannelFactory (string endpointConfigurationName, Uri remoteAddress);

new System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)> : string * Uri -> System.ServiceModel.Web.WebChannelFactory<'Channel (requires 'Channel : null)>

Public Sub New (endpointConfigurationName As String, remoteAddress As Uri)

Parâmetros

endpointConfigurationName: String

O nome no arquivo de configuração de aplicativo em que o canal está configurado.

remoteAddress: Uri

O URI do serviço Web que é chamado.

Exemplos

O código a seguir mostra como usar esse construtor para criar uma WebChannelFactory<TChannel> instância e chamar um serviço.

Uri baseAddress = new Uri("http://localhost:8000");
WebServiceHost host = new WebServiceHost(typeof(Service), baseAddress);
try
{
    host.Open();

    // The endpoint name passed to the constructor must match an endpoint element
    // in the application configuration file
    WebChannelFactory<IService> cf = new WebChannelFactory<IService>("MyEndpoint", new Uri("http://localhost:8000"));
    IService channel = cf.CreateChannel();
    string s;

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ");
    s = channel.EchoWithGet("Hello, world");
    Console.WriteLine("   Output: {0}", s);
}
catch (CommunicationException ex)
{
    Console.WriteLine("An exception occurred: " + ex.Message);
}

Dim baseAddress As New Uri("http://localhost:8000")
Dim host As New WebServiceHost(GetType(Service), baseAddress)
Try
    host.Open()

    ' The endpoint name passed to the constructor must match an endpoint element
    ' in the application configuration file
    Dim cf As New WebChannelFactory(Of IService)("MyEndpoint", New Uri("http://localhost:8000"))
    Dim channel As IService = cf.CreateChannel()
    Dim s As String

    Console.WriteLine("Calling EchoWithGet via HTTP GET: ")
    s = channel.EchoWithGet("Hello, world")
    Console.WriteLine("   Output:  0}", s)
Catch ex As CommunicationException
    Console.WriteLine("An exception occurred: " + ex.Message)
End Try

Comentários

O endpointConfigurationName parâmetro deve ser definido como o mesmo valor que o name atributo do <endpoint> elemento no arquivo de configuração do aplicativo.

Aplica-se a

Partilhar via

WebChannelFactory<TChannel> Construtores

Definição

Sobrecargas

WebChannelFactory<TChannel>()

Aplica-se a

WebChannelFactory<TChannel>(Binding)

Parâmetros

Exemplos

Aplica-se a

WebChannelFactory<TChannel>(ServiceEndpoint)

Parâmetros

Exemplos

Aplica-se a

WebChannelFactory<TChannel>(String)

Parâmetros

Exemplos

Comentários

Aplica-se a

WebChannelFactory<TChannel>(Type)

Parâmetros

Comentários

Aplica-se a

WebChannelFactory<TChannel>(Uri)

Parâmetros

Exemplos

Aplica-se a

WebChannelFactory<TChannel>(Binding, Uri)

Parâmetros

Exemplos

Aplica-se a

WebChannelFactory<TChannel>(String, Uri)

Parâmetros

Exemplos

Comentários

Aplica-se a

Recursos adicionais