.Net Language Support

One of the benefits of the Microsoft .Net platform is its support for multiple programming languages. RTI Data Distribution Service supports multiple .Net-compatible languages. The following describes how users of various languages can best use this API documentation.

C# Language

Namespaces

Namespace scope is indicated in the documentation with the double-colon operator (::). This syntax is for the benefit of C++/CLI users. The equivalent C# operator is the dot (.).

References

When reading this API documentation, C# users will see '^' and/or '%' notation in a number of method prototypes. For example:

  void DomainParticipant::set_default_publisher_qos(
      PublisherQos^ qos);
  void DomainParticipant::delete_publisher(
      Publisher^% publisher);
  void DomainParticipant::get_default_flowcontroller_property(
      FlowControllerProperty_t% property);

This syntax is for the benefit of C++/CLI users. The '^' notation indicates a managed pointer. Since managed pointers are implicit in C#, this syntax can be ignored. The '%' notation is equivalent to the use of the ref keyword in C#.

The equivalent C# prototypes are therefore the following:

  void DomainParticipant.set_default_publisher_qos(
      PublisherQos qos);
  void DomainParticipant.delete_publisher(
      ref Publisher publisher);
  void DomainParticipant.get_default_flowcontroller_property(
      ref FlowControllerProperty_t property);

Arrays

Arrays are expressed with the syntax array<Foo>, meaning a managed array of element type Foo. This syntax is for the benefit of C++/CLI users. The equivalent syntax in C# is Foo[].

C++/CLI Language

This documentation reflects the use of the API from the C++/CLI language. (This language is sometimes also referred to as "managed C++" or "C++ with managed extensions.")

Visual Basic .Net Language

RTI Data Distribution Service supports capabilities not offered by the Visual Basic language, such as unsigned data types. Therefore, RTI does not offer support for this language at this time.

RTI Data Distribution Service .Net APIs Version 4.5e Copyright © 23 Oct 2011 Real-Time Innovations, Inc