SoapConnection Object Methods
\The Sandbox \PB History & Future \New in PB 10.5 \Web Services Enhancements \SoapConnection Methods
About .NET Web
Service Engine
Using .NET Web
Service Engine
EasySoap Web
Service Engine
SoapConnection
Methods

Methods for .NET SOAP connection options

Instead of using the SetOptions method for setting all SOAP connection options in a single argument, you can use separate methods to apply the specific options that your Web service application requires. The following methods can be used to supplement or replace the SetOptions method for .NET Web services:

SoapConnection method

Description

Syntax

RemoveAuthentication

Clears Basic, Digest, Domain, and Integrated Windows Authentication information from the SoapConnection object.

conn.RemoveAuthentication ()

SetBasicAuthentication

Sets client identification information for Web services that require Basic authentication.

conn.SetBasicAuthentication (string domain, string userID, string password)

SetClientCertificateFile

Sets the certificate file or files to use to connect to a Web service. Filename can be a list of files separated by semicolons.

conn.SetClientCertificateFile (string filename)

SetTimeout

Sets the client-side timeout value for a SOAP connection.

conn.SetTimeout (long seconds)

UseIntegratedWindowsAuthentication

Determines whether the SoapConnection object uses Integrated Windows Authentication to connect to a Web service.

conn.UseIntegratedWindowsAuthenticatio n (boolean useIWA)

All SoapConnection methods return a value of the long datatype. They return 0 for success and 50 for failure. The conn variable in the method syntaxes holds an instantiated SoapConnection object.

Methods for EasySoap SOAP connection options

The following methods can be used to supplement or replace the SetOptions method for EasySoap Web services:

SoapConnection method

Description

Syntax

SetSoapLogFile

Sets the name of a file for logging raw SOAP messages

conn.SetSoapLogFile (string filename)

SetTimeout

Sets the client-side timeout value for a SOAP connection

conn.SetTimeout (long seconds)

UseConnectionCache

Determines whether a connection cache is used for the Web service connection

conn.UseConnectionCache (boolean cache)

All SoapConnection methods return a value of the long datatype. They return 0 for success and 50 for failure. The conn variable in the method syntaxes holds an instantiated SoapConnection object.

For more information on using the new SoapConnection methods, see the PowerBuilder Extension Reference in the online Help or the Release Bulletin.

Alternative method for setting a proxy server connection

If your application users connect to the Internet through a proxy server, you can use the SetProxyServer method instead of the SetProxyServerOptions method to assign proxy server connection parameters.

The SetProxyServer method has two syntaxes:

  • conn.SetProxyServer (string address, string userID, string password)
  • conn.SetProxyServer (string hostname, long port, string userID, string password)

All SoapConnection methods return a value of the long datatype. They return 0 for success and 50 for failure. The conn variable in the method syntaxes holds an instantiated SoapConnection object.

The first syntax has three string arguments. For this syntax, you set the value of the proxy server port in the address argument along with the host name of the proxy server. You can also include a proxy endpoint in the address argument using the format: http://hostname:port/path.

The second syntax has arguments for the proxy server address, port, user ID, and password. The port argument takes a long datatype and the other arguments take string datatypes. These are the same components of the single string argument that you use with the older SetProxyServerOptions method.

 

PBL Peeper PB Help PB History
& Future About Us Feedback Site Map

Google
 
Web www.techno-kitten.com
www.sybase.com