The WCFConnection object is an instance of the WCFConnection class, and includes all options for calling Web and WCF services.
The WCF Client Proxy project creates a WCFConnection object instance that is assigned, by default, to the wcfConnectionObject property of the proxy NVO generated when you select Generate Proxy from the project object's context menu or from the Design menu of the Project painter.
If necessary, you can replace the default WCFConnection object by creating a separate instance and assigning it to the wcfConnectionObject property of the generated proxy NVO, or you can modify individual properties of the default instance.
| WCFConnection property | Type | Description |
|---|---|---|
| BindingType | WCFBindingType (enumeration) |
Specifies the binding type and communciation format
to use when accessing a service.
The default value is generated from the service contract. If you delete this value, the connection is attempted using BasicHttpBinding as the default binding type. Values are: BasicHttpBinding, wsHttpBinding, NetTcpBinding, and NetNamedPipeBinding
.
WCF connection bindings are described on the MSDN Web site: http://msdn.microsoft.com/en-us/library/ms731092.aspx. |
| ClientCredential | WCFClientCredential (class) | Specifies the WCF credential to use for communication with the service. |
| EndpointAddress | WCFEndpointAddress (class) | Specifies a URL for the remote service, and tells the service engine where the service resides. If the endpoint is not explicitly set, the service engine uses the default endpoint embedded in the service contract file and in the generated service assembly. |
| ProxyServer | WCFProxyServer (class) | Allows you to specify credentials for a proxy server if the client machine is behind a firewall. If the client machine is directly connected to the Internet, you need not set this property. |
| Timeout | String | Specifies how long the WCF engine waits, while invoking the service, before timing out. The default value is 10 minutes ("00:10:00"). The format for the time is "hh:mm:ss". The service might have a different timeout value on the server side. |
| BasicHttpBinding | WCFBasicHttpBinding (class) | Defines binding settings for BasicHttpBinding. This property is used only when the BindingType property is BasicHttpBinding. |
| wsHttpBinding | WCFwsHttpBinding (class) | Defines binding settings for wsHttpBinding. This property is used only when the BindingType property is wsHttpBinding. |
| netTcpBinding | WCFNetTcpBinding (class) | Defines binding settings for NetTcpBinding. This property is used only when the BindingType property is NetTcpBinding. |
| netNamedPipeBinding | WCFNetNamedPipeBinding (class) | Defines binding settings for NetNamedPipeBinding. This property is used only when the BindingType property is NetNamedPipeBinding. |
| SoapMessageHeader | WCFSoapMessageHeader (class) | Defines SoapHeader items for the SOAP request message. |
| WCFConnection event | Occurs |
|---|---|
| Constructor | Immediately before the Open event occurs in the window |
| Destructor | Immediately after the Close event occurs in the window |