IpcChannel.Parse(String, String) Method

Definition

Namespace:

System.Runtime.Remoting.Channels.Ipc

Assembly:

System.Runtime.Remoting.dll

Extracts the channel URI and the remote well-known object URI from the specified URL.

public:
 virtual System::String ^ Parse(System::String ^ url, [Runtime::InteropServices::Out] System::String ^ % objectURI);

public string Parse (string url, out string objectURI);

abstract member Parse : string * string -> string
override this.Parse : string * string -> string

Public Function Parse (url As String, ByRef objectURI As String) As String

Parameters

url

String

The URL from which to extract the URI of the remote well-known object.

objectURI

String

When this method returns, contains a String that holds the URI of the remote well-known object. This parameter is passed uninitialized.

Returns

String

The URI of the current channel.

Implements

Parse(String, String)

Examples

The following code example shows how to use the Parse method. This code example is part of a larger example provided for the IpcChannel class.

// Parse the channel's URI.
array<String^>^ urls = serverChannel->GetUrlsForUri( L"RemoteObject.rem" );
if ( urls->Length > 0 )
{
   String^ objectUrl = urls[ 0 ];
   String^ objectUri;
   String^ channelUri = serverChannel->Parse( objectUrl,  objectUri );
   Console::WriteLine( L"The object URI is {0}.", objectUri );
   Console::WriteLine( L"The channel URI is {0}.", channelUri );
   Console::WriteLine( L"The object URL is {0}.", objectUrl );
}

// Parse the channel's URI.
string[] urls = serverChannel.GetUrlsForUri("RemoteObject.rem");
if (urls.Length > 0)
{
    string objectUrl = urls[0];
    string objectUri;
    string channelUri = serverChannel.Parse(objectUrl, out objectUri);
    Console.WriteLine("The object URI is {0}.", objectUri);
    Console.WriteLine("The channel URI is {0}.", channelUri);
    Console.WriteLine("The object URL is {0}.", objectUrl);
}

Remarks

A URI of an object is a value that uniquely identifies a specific object instance.