Quick Reference

.NET Wrapper Reference

This document covers the following topics:

Attributes
Classes

Attributes

Attribute classes are defined and implemented in the .NET Wrapper runtime and used in the C# client interface object code to hold information extracted from the IDL file.

EntireXVersionAttribute

This attribute contains version information.

Example

[EntireXVersion("10.1.0.0")]
public class Example

LibraryAttribute

This attribute contains the library name.

Example

[Library("EXAMPLE")]
public class Example

BrokerAttribute

This attribute contains the Broker ID.

Example (without SSL)

[Broker("localhost:1971")]
public class Example

Example (with SSL)

[Broker("ssl://localhost:22101?trust_store=C:\SoftwareAG\EntireX/etc/ExxCACert.jks&key_store=C:\SoftwareAG\EntireX/etc/ExxJavaAppCert.jks&key_passwd=ExxJavaAppCert")]
public class Example

ServiceAttribute

This attribute contains the service name.

Example

[Service("RPC/SRV1/CALLNAT")]
public class Example

ProgramAttribute

This attribute contains the program name.

Example

[Program("CALC")]
public int Calculator(
  [SendAs(IdlType.A, Length=1f)][In] string operation,
  [SendAs(IdlType.I4)][In] int operand1,
  [SendAs(IdlType.I4)][In] int operand2
)

SendAsAttribute

This attribute contains type, length (fixed or dynamic) and dimension (fixed or dynamic) information.

Direction Attributes (In, Out)

These attributes contain direction information. They are supported natively by C#.

Example

[Program("HELLO")]
public void Hello(
  [SendAs(IdlType.A, Length=80f)][In] string client,
  [SendAs(IdlType.A, Length=80f)][In, Out] ref StringBuilder mail
)

Classes

The .NET Wrapper runtime defines and implements several generic service classes that are used in the generated C# client interface object and by .NET client applications.

BigNumeric

Implementation of decimal values without upper and lower limit and a default number of 99 digits after the decimal sign.

Constructors

public BigNumeric (  BigNumeric number )

Copy Constructor.

public BigNumeric (  decimal number )

Constructor translating a decimal number into a BigNumeric value.

public BigNumeric (  Int32 number )

Constructor translating an Int32 number into a BigNumeric value.

public BigNumeric (  Int64 number )

Constructor translating an Int64 number into a BigNumeric value.

public BigNumeric (  double number )

Constructor translating a double to its exact BigNumeric representation.

public BigNumeric (  string number )

Constructor converting the string representation of a number into a BigNumeric object. The string representation consists of an optional sign, '+' or '-', followed by a sequence of zero or more decimal digits, optionally followed by a fraction which consists of a decimal point followed by zero or more decimal digits and optionally followed by an exponent which consists of the character 'e' or 'E' followed by one or more decimal digits. The value must not exceed the size of the N(U)/P(U) data type.

public BigNumeric (  string number , CulturInfo info )

Constructor converting the string representation of a number into a BigNumeric object. The desired culture info is used to interpret the numeric string.

Methods

public int GetHashCode()

Returns the hash code of the instance.

public string ToString()

Converts the value of the instance to its string representation.

public string ToString( NumberFormatInfo info )

Converts the value of the instance to its string representation using the desired number format.

public BigInteger Truncate()

Returns the integral part of the number.

public BigNumeric Truncate (  int scale )

Returns a new BigNumeric with a maximum number of digits after the decimal sign. The number is truncated to the desired precision if necessary.

public BigNumeric Round (  int scale )

Returns a new BigNumeric with a maximum number of digits after the decimal sign. The number is rounded to the desired precision if necessary. Rounding is performed according to the rounding mode "HALF_UP" of Java class BigDecimal.

public bool isNegative()

Returns true for negative numbers.

public static BigNumeric Random (  int preDecimal , int postDecimal )

Create a random BigNumeric number with the desired number of predecimal and a maximum of 99 postdecimal digits.

Operators

public static BigNumeric operator + ( BigNumeric operand1 , BigNumeric operand2 )

Adds two BigNumerics. The result inherits the scale of operand1.

public static BigNumeric operator - ( BigNumeric operand1 , BigNumeric operand2 )

Subtracts two BigNumerics. The result inherits the scale of operand1.

public static BigNumeric operator * ( BigNumeric operand1 , BigNumeric operand2 )

Multiplies two BigNumerics. The result inherits the scale of operand1.

public static BigNumeric operator / ( BigNumeric operand1 , BigNumeric operand2 )

Divides two BigNumerics. The result inherits the scale of operand1.

public static implicit operator BigNumeric ( decimal value )

Converts a decimal value to a BigNumeric.

public static implicit operator BigNumeric ( Int32 value )

Converts an int value to a BigNumeric.

public static implicit operator BigNumeric ( Int64 value )

Converts a long value to a BigNumeric.

public static explicit operator Decimal ( BigNumeric value )

Converts the BigNumeric to a decimal, throws an exception if the value doesn't match the decimal's numeric range.

public static bool operator < ( BigNumeric left , BigNumeric right )

Compares the value of two BigNumerics.

public static bool operator <= ( BigNumeric left , BigNumeric right )

Compares the value of two BigNumerics.

public static bool operator > ( BigNumeric left , BigNumeric right )

Compares the value of two BigNumerics.

public static bool operator >= ( BigNumeric left , BigNumeric right )

Compares the value of two BigNumerics.

public static bool operator == ( BigNumeric left , BigNumeric right )

Compares the value of two BigNumerics.

public static bool operator != ( BigNumeric left , BigNumeric right )

Compares the value of two BigNumerics.

bool Equals ( object o )

Compares the desired object with the value of this.

public static bool operator < ( BigNumeric left , Decimal right )