WebChannelFactory<TChannel> Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the WebChannelFactory<TChannel> class.
Overloads
WebChannelFactory<TChannel>() |
Initializes a new instance of the WebChannelFactory<TChannel> class. |
WebChannelFactory<TChannel>(Binding) |
Initializes a new instance of the WebChannelFactory<TChannel> class. |
WebChannelFactory<TChannel>(ServiceEndpoint) |
Initializes a new instance of the WebChannelFactory<TChannel> class. |
WebChannelFactory<TChannel>(String) |
Initializes a new instance of the WebChannelFactory<TChannel> class. |
WebChannelFactory<TChannel>(Type) |
Initializes a new instance of the WebChannelFactory<TChannel> class. |
WebChannelFactory<TChannel>(Uri) |
Initializes a new instance of the WebChannelFactory<TChannel> class with the specified Uri. |
WebChannelFactory<TChannel>(Binding, Uri) |
Initializes a new instance of the WebChannelFactory<TChannel> class with the specified binding and Uri. |
WebChannelFactory<TChannel>(String, Uri) |
Initializes a new instance of the WebChannelFactory<TChannel> class with the specified endpoint configuration and Uri. |
WebChannelFactory<TChannel>()
Initializes a new instance of the WebChannelFactory<TChannel> class.
public:
WebChannelFactory();
public WebChannelFactory ();
Public Sub New ()
Applies to
WebChannelFactory<TChannel>(Binding)
Initializes a new instance of the WebChannelFactory<TChannel> class.
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)
Parameters
- binding
- Binding
The binding to use when creating the channel.
Examples
The following code shows how use this constructor to create a WebChannelFactory<TChannel> and use it to call a WCF service.
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
Applies to
WebChannelFactory<TChannel>(ServiceEndpoint)
Initializes a new instance of the WebChannelFactory<TChannel> class.
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)
Parameters
- endpoint
- ServiceEndpoint
The endpoint to use when creating the channel.
Examples
The following code shows how use this constructor to create a WebChannelFactory<TChannel> and use it to call a WCF service.
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
Applies to
WebChannelFactory<TChannel>(String)
Initializes a new instance of the WebChannelFactory<TChannel> class.
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)
Parameters
- endpointConfigurationName
- String
The name within the application configuration file where the channel is configured.
Examples
The following code shows how use this constructor to create a WebChannelFactory<TChannel> instance and use it to call a WCF service.
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
Remarks
The endpointConfigurationName
parameter must be set to the same value as the name
attribute of the <endpoint>
element in the application configuration file.
Applies to
WebChannelFactory<TChannel>(Type)
Initializes a new instance of the WebChannelFactory<TChannel> class.
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)
Parameters
- channelType
- Type
The channel type to use.
Remarks
The type passed for the type parameter must be an interface.
Applies to
WebChannelFactory<TChannel>(Uri)
Initializes a new instance of the WebChannelFactory<TChannel> class with the specified Uri.
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)
Parameters
- remoteAddress
- Uri
The URI of the Web service that is called.
Examples
The following code shows how to use this constructor to create a WebChannelFactory<TChannel> instance and call a service.
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
Applies to
WebChannelFactory<TChannel>(Binding, Uri)
Initializes a new instance of the WebChannelFactory<TChannel> class with the specified binding and Uri.
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)
Parameters
- binding
- Binding
The binding to use.
- remoteAddress
- Uri
The URI of the Web service that is called.
Examples
The following code shows how to use this constructor to create a WebChannelFactory<TChannel> instance and call a service.
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
Applies to
WebChannelFactory<TChannel>(String, Uri)
Initializes a new instance of the WebChannelFactory<TChannel> class with the specified endpoint configuration and Uri.
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)
Parameters
- endpointConfigurationName
- String
The name within the application configuration file where the channel is configured.
- remoteAddress
- Uri
The URI of the Web service that is called.
Examples
The following code shows how to use this constructor to create a WebChannelFactory<TChannel> instance and call a service.
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
Remarks
The endpointConfigurationName
parameter must be set to the same value as the name
attribute of the <endpoint>
element in the application configuration file.