The message port API provides functions for passing messages between applications. An application should register its own local port to receive messages from remote applications. If a remote application sends a message, the registered callback function of the local port is called. The trusted message-port API allows communications between applications that are signed by the same developer(author) certificate.

Constructors

MessagePort(String, Boolean)

Initializes the instance of the MessagePort class.

Declaration

public MessagePort(string portName, bool trusted)

Parameters

Type	Name	Description
String	portName	The name of the local message port.
Boolean	trusted	If true, it is the trusted message port of application, otherwise false.

API Version

Examples

MessagePort messagePort = new MessagePort("SenderPort", true);

Exceptions

Type	Condition
ArgumentException	Thrown when portName is null or empty.

Properties

Listening

If true, the message port is listening, otherwise false.

Declaration

public bool Listening { get; }

Property Value

Type	Description
Boolean

API Version

PortName

The name of the local message port.

Declaration

public string PortName { get; }

Property Value

Type	Description
String

API Version

Trusted

If true, the message port is a trusted port, otherwise false.

Declaration

public bool Trusted { get; }

Property Value

Type	Description
Boolean

API Version

Methods

Dispose()

Releases all resources used by the MessagePort class.

Declaration

public void Dispose()

API Version

Dispose(Boolean)

Releases the unmanaged resources used by the MessagePort class specifying whether to perform a normal dispose operation.

Declaration

protected virtual void Dispose(bool disposing)

Parameters

Type	Name	Description
Boolean	disposing	true for a normal dispose operation; false to finalize the handle.

API Version

Finalize()

Destructor of the MessagePort class.

Declaration

protected void Finalize()

Listen()

Declaration

public void Listen()

API Version

Examples

MessagePort messagePort = new MessagePort("SenderPort", true);
messagePort.MessageReceived += MessageReceivedCallback;
messagePort.Listen();

Exceptions

Type	Condition
InvalidOperationException	Thrown when portName is already used, when there is an I/O error.
ArgumentException	Thrown when there is an invalid parameter.
OutOfMemoryException	Thrown when out of memory.

Send(Bundle, String, String)

Sends an untrusted message to the message port of a remote application.

Declaration

public void Send(Bundle message, string remoteAppId, string remotePortName)

Parameters

Type	Name	Description
Bundle	message	The message to be passed to the remote application, the recommended message size is under 4KB.
String	remoteAppId	The ID of the remote application.
String	remotePortName	The name of the remote message port.

API Version

Examples

MessagePort messagePort = new MessagePort("SenderPort", true);
messagePort.MessageReceived += MessageReceivedCallback;
messagePort.Listen();
using (var message = new Tizen.Application.Bundle())
{
    message.AddItem("message", "a_string");
    messagePort.Send(message, "ReceiverAppID", "ReceiverPort");
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when there is an I/O error, when the port is not found.
ArgumentException	Thrown when there is an invalid parameter.
OutOfMemoryException	Thrown when out of memory.
ArgumentOutOfRangeException	Thrown when message has exceeded the maximum limit(4KB).

Send(Bundle, String, String, Boolean)

Sends a message to the message port of a remote application.

Declaration

public void Send(Bundle message, string remoteAppId, string remotePortName, bool trusted)

Parameters

Type	Name	Description
Bundle	message	The message to be passed to the remote application, the recommended message size is under 4KB.
String	remoteAppId	The ID of the remote application.
String	remotePortName	The name of the remote message port.
Boolean	trusted	If true, it is the trusted message port of remote application, otherwise false.

API Version

Examples

MessagePort messagePort = new MessagePort("SenderPort", true);
messagePort.MessageReceived += MessageReceivedCallback;
messagePort.Listen();
using (var message = new Tizen.Application.Bundle())
{
    message.AddItem("message", "a_string");
    messagePort.Send(message, "ReceiverAppID", "ReceiverPort", true);
}

Exceptions

Type	Condition
InvalidOperationException	Thrown when there is an I/O error, when the port is not found.
ArgumentException	Thrown when there is an invalid parameter.
OutOfMemoryException	Thrown when out of memory.
ArgumentOutOfRangeException	Thrown when message has exceeded the maximum limit(4KB).
UnauthorizedAccessException	Thrown when the remote application is not signed with the same certificate.

StopListening()

Unregisters the local message port.

Declaration

public void StopListening()

API Version

Examples

MessagePort messagePort = new MessagePort("SenderPort", true);
messagePort.MessageReceived += MessageReceivedCallback;
messagePort.Listen();
using (var message = new Tizen.Application.Bundle())
{
    message.AddItem("message", "a_string");
    messagePort.Send(message, "ReceiverAppID", "ReceiverPort");
}
messagePort.StopListening();

Exceptions

Type	Condition
InvalidOperationException	Thrown when messageport is already stopped, when there is an I/O error, when the port is not found.
ArgumentException	Thrown when there is an invalid parameter.
OutOfMemoryException	Thrown when out of memory.

Events

MessageReceived

Called when a message is received.

Declaration

public event EventHandler<MessageReceivedEventArgs> MessageReceived

Event Type

Type	Description
EventHandler<MessageReceivedEventArgs>

API Version

Examples

MessagePort messagePort = new MessagePort("SenderPort", true);
messagePort.MessageReceived += MessageReceivedCallback;
static void MessageReceivedCallback(object sender, MessageReceivedEventArgs e)
{
    Console.WriteLine("Message Received ");
    if (e.Remote.AppId != null) {
        Console.WriteLine("from :"+e.Remote.AppId);
    }
}

Implements

System.IDisposable