Skip to main content
Previous section   Next section

SoapBindingStyle

Specifies the binding style or SOAP invocation mechanism used by this query, when it is used as a web method. Applies only in a class that is defined as a web service or web client.

Usage

To override the default binding style used by the query (when it is used as a web method), use the following syntax:

Query name(formal_spec) As classname [ WebMethod, SoapBindingStyle = soapbindingstyle ]
{
   //implementation
}

Where soapbindingstyle is one of the following values:

  • document — This web method uses document-style invocation.

    With this binding style, the SOAP messages are formatted as documents and typically have only one part.

    In the SOAP messages, the <Body> element typically contains a single child element. Each child of the <Body> element corresponds to a message part.

  • rpc — This web method uses RPC (Remote Procedure Call)-style invocation.

    With this binding style, the SOAP messages are formatted as messages with multiple parts.

    In the SOAP messages, the <Body> element contains a single child element whose name is taken from the corresponding operation name. This element is a generated wrapper element, and it contains one child element for each argument in the argument list of the method.

Important:

For a web service that you create manually, the default value of this keyword is usually suitable. When you generate a web client or service from a WSDL with the SOAP Wizard, Caché sets this keyword as appropriate for that WSDL; if you modify the value, your web client or service may no longer work.

Details

This keyword lets you specify the binding style used by this query when it is invoked as a web method.

For a given query, this keyword overrides the SoapBindingStyle class keyword.

Default

If you omit this keyword, the style attribute of <soap:operation> element is determined instead by the value for the SoapBindingStyle class keyword instead.

Relationship to WSDL

For information, see the entry for the SoapBindingStyle method keyword. (Note that the class keyword of the same name affects more parts of the WSDL than the method keyword and query keyword do.)

Effect on SOAP Messages

For information, see the entry for the SoapBindingStyle class keyword.

See Also

Previous section   Next section