DotNetRun (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Parameters of procedure to run
Type of parameter
Call to DotNetRun

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DotNetRun (Function)

In french: DotNetExécute

Runs a procedure on a .Net server.

Note: The procedure parameters must be specified before using DotNetRun via the .Net structure (see the Notes).

Example

// This example assumes that the eightball module is available from "www.gotdotnet.com".
// The example would no longer operate if this module was not available on the site
DotNet.Value[1] = "enter a question" + ...
"just for fun: what would the answer be?"
DotNet.Name[1] = "psQuestion"
DotNet.Type[1] = DotNetStringType
IF DotNetRun("www.gotdotnet.com/playground/services/EightBall/eightballws.asmx", ...
"Ask", "http://tempuri.org/", "http://tempuri.org/Ask") THEN
Info(DotNetGetResult(DotNetResult))
ELSE
IF DotNetError(DotNetErrMessage) ~= "" THEN
Error(ErrorInfo())
ELSE
Error(".Net error: " + ...
DotNetError(DotNetErrMessage))
END
END

Syntax

<Result> = DotNetRun(<Server URL> , <Procedure Name> [, <Procedure Namespace> [, <Procedure Action> [, <Encoding Style>]]])

<Result>: Boolean

True if the communication was established with the server,
False otherwise. To find out the error details, use ErrorInfo associated with the errMessage constant.

<Server URL>: Character string (with quotes)

URL of server to contact. This parameter is supplied in the documentation of .Net server.

<Procedure Name>: Character string

Name of the procedure that will be run on the specified server. This parameter is supplied in the documentation of .Net server.
The procedure name is case sensitive (uppercase/lowercase characters).

<Procedure Namespace>: Optional character string

Namespace of procedure to run. This parameter is supplied in the documentation of .Net server.

<Procedure Action>: Optional character string

Action of procedure (also called "DotNetAction"). This parameter is supplied in the documentation of .Net server.

<Encoding Style>: Optional character string

Encoding style of procedure (also called "EncodingStyle"). This parameter is supplied in the documentation of .Net server.

Remarks

Parameters of procedure to run

The following structure is used by WINDEV or WEBDEV to pass parameters to a procedure run on a .Net XML Web server:

Variable	Type	Details

DotNet.NameSpace	Optional character string	"NameSpace" of parameter
DotNet.Name	Character string	Name of parameter
DotNet.XMLParam	Optional character string	Full description of parameter in XML format. The other parameters (Value, Name, Type, NameSpace and EncodingStyle) are ignored if this parameter is specified.
DotNet.EncodingStyle	Optional character string	Encoding style of parameter
DotNet.Type	Constant	Type of parameter
DotNet.Value	Any type	Value of parameter

This structure must be used for each parameter. For example:

DotNet.Value[1] = 94010
DotNet.Name[1] = "ZipCode"
DotNet.Type[1] = DotNetStringType

This structure is equivalent to:

DotNet.XMLParam[1] = <ZipCode xsi:type="xsd:string">94010</ZipCode>

Type of parameter

The type of parameter can be:

Constant	Type

DotNetBase64BinaryType	Binary
DotNetHexBinaryType	Hexadecimal binary
DotNetBooleanType	Boolean
DotNetStringType	Character string
DotNetNormalizedStringType	Character string without carriage return (CR) and without tabulation (TAB)
DotNetDecimalType	Any number without limit
DotNetIntType	Integer included between - 2 147 483 648 and + 2 147 483 647)
DotNetShortType	Short integer
DotNetUnsignedShortType	Unsigned short integer
DotNetIntegerType	Integer (no limit)
DotNetLongType	Long integer
DotNetUnsignedLongType	Long unsigned integer
DotNetNegativeIntegerType	Negative integer (except 0)
DotNetNonNegativeIntegerType	Non-negative integer
DotNetNonPositiveIntegerType	Non-positive integer
DotNetUnsignedIntType	Unsigned integer
DotNetPositiveIntegerType	Positive integer (except 0)
DotNetByteType	Byte
DotNetUnsignedByteType	Unsigned byte
DotNetFloatType	Real
DotNetDoubleType	Double real
DotNetAnyURIType	URL address

Call to DotNetRun

After the call to DotNetRun:

The procedure parameters are erased.
The structure of the header specified by DotNetAddHeader is erased.
DotNetGetResult returns the result of the procedure run.
DotNetError returns the error message of the procedure run.

Component : wd250com.dll