Runs a procedure on a .Net server.
Remark: The procedure parameters must be specified before using DotNetRun via the .Net structure (see the Notes).
// 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 get more details on the error, use ErrorInfo with the errMessage constant.
<Server URL>: Character string
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 | Parameter name |
| DotNet.XMLParam | Optional character string | Full parameter description 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 | Parameter value |
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>
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 |
After the call to DotNetRun:
- The procedure parameters are deleted.
- The structure of the header specified with DotNetAddHeader is deleted.
- DotNetGetResult returns the result of the procedure run.
- DotNetError returns the error message of the procedure run.