Freigeben über

RemotingServices.Connect Methode

  • Referenz

Definition

Namespace:
System.Runtime.Remoting
Assembly:
mscorlib.dll

Erstellt einen Proxy für ein bekanntes Objekt.

Überlädt

Connect(Type, String)

Erstellt einen Proxy für ein bekanntes Objekt, wenn der Type und die URL angegeben sind.
Connect(Type, String, Object)

Erstellt einen Proxy für ein bekanntes Objekt, wenn der Type, die URL und channelspezifische Daten angegeben sind.

Connect(Type, String)

Erstellt einen Proxy für ein bekanntes Objekt, wenn der Type und die URL angegeben sind.

public:
 static System::Object ^ Connect(Type ^ classToProxy, System::String ^ url);
public static object Connect (Type classToProxy, string url);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Connect (Type classToProxy, string url);
[System.Runtime.InteropServices.ComVisible(true)]
[System.Security.SecurityCritical]
public static object Connect (Type classToProxy, string url);
static member Connect : Type * string -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Connect : Type * string -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Security.SecurityCritical>]
static member Connect : Type * string -> obj
Public Shared Function Connect (classToProxy As Type, url As String) As Object

Parameter

classToProxy
Type

Der Type eines bekannten Objekts auf der Serverseite, mit dem Sie eine Verbindung herstellen möchten.

url
String

Die URL der Serverklasse.

Gibt zurück

Object

Ein Proxy für das Remoteobjekt, der auf einen Endpunkt zeigt, der von dem angegebenen bekannten Objekt unterstützt wird.

Attribute
ComVisibleAttribute SecurityCriticalAttribute

Ausnahmen

SecurityException

Der direkte Aufrufer hat keine Berechtigung zum Konfigurieren von Remotingtypen und Channels.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie die Connect Methode zum Erstellen eines Proxys zu einem bekannten Objekt verwenden.

Console::WriteLine( "Connecting to SampleNamespace::SampleWellKnown." );
SampleWellKnown ^ proxy = dynamic_cast<SampleWellKnown^>(RemotingServices::Connect( SampleWellKnown::typeid, const_cast<String^>(SERVER_URL) ));
Console::WriteLine( "Connected to SampleWellKnown" );

// Verifies that the Object* reference is to a transparent proxy.
if ( RemotingServices::IsTransparentProxy( proxy ) )
      Console::WriteLine( "proxy is a reference to a transparent proxy." );
else
      Console::WriteLine( "proxy is not a transparent proxy.  This is unexpected." );

// Calls a method on the server Object*.
Console::WriteLine( "proxy->Add returned {0}.", proxy->Add( 2, 3 ) );

Console.WriteLine("Connecting to SampleNamespace.SampleWellKnown.");

SampleWellKnown proxy =
   (SampleWellKnown)RemotingServices.Connect(typeof(SampleWellKnown), SERVER_URL);

Console.WriteLine("Connected to SampleWellKnown");

// Verifies that the object reference is to a transparent proxy.
if (RemotingServices.IsTransparentProxy(proxy))
    Console.WriteLine("proxy is a reference to a transparent proxy.");
else
    Console.WriteLine("proxy is not a transparent proxy.  This is unexpected.");

// Calls a method on the server object.
Console.WriteLine("proxy.Add returned {0}.", proxy.Add(2, 3));

Console.WriteLine("Connecting to SampleNamespace.SampleWellKnown.")

Dim proxy As SampleWellKnown = _
   CType(RemotingServices.Connect(GetType(SampleWellKnown), SERVER_URL), SampleWellKnown)

Console.WriteLine("Connected to SampleWellKnown")

' Verifies that the object reference is to a transparent proxy.
If RemotingServices.IsTransparentProxy(proxy) Then
   Console.WriteLine("proxy is a reference to a transparent proxy.")
Else
   Console.WriteLine("proxy is not a transparent proxy.  This is unexpected.")
End If

' Calls a method on the server object.
Console.WriteLine("proxy.Add returned {0}.", proxy.Add(2, 3))

Hinweise

Das zurückgegebene Proxyobjekt verweist auf einen Endpunkt, der vom angegebenen bekannten Objekt bereitgestellt wird. Es werden keine Nachrichten über das Netzwerk gesendet, bis eine Methode auf dem Proxy aufgerufen wird.

Gilt für

Connect(Type, String, Object)

Erstellt einen Proxy für ein bekanntes Objekt, wenn der Type, die URL und channelspezifische Daten angegeben sind.

public:
 static System::Object ^ Connect(Type ^ classToProxy, System::String ^ url, System::Object ^ data);
public static object Connect (Type classToProxy, string url, object data);
[System.Runtime.InteropServices.ComVisible(true)]
public static object Connect (Type classToProxy, string url, object data);
[System.Runtime.InteropServices.ComVisible(true)]
[System.Security.SecurityCritical]
public static object Connect (Type classToProxy, string url, object data);
static member Connect : Type * string * obj -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
static member Connect : Type * string * obj -> obj
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Security.SecurityCritical>]
static member Connect : Type * string * obj -> obj
Public Shared Function Connect (classToProxy As Type, url As String, data As Object) As Object

Parameter

classToProxy
Type

Der Type des bekannten Objekts, mit dem Sie eine Verbindung herstellen möchten.

url
String

Die URL des bekannten Objekts.

data
Object

Channelspezifische Daten. Kann null sein.

Gibt zurück

Object

Ein Proxy, der auf einen Endpunkt zeigt, der von dem angeforderten bekannten Objekt unterstützt wird.

Attribute
ComVisibleAttribute SecurityCriticalAttribute

Ausnahmen

SecurityException

Der direkte Aufrufer hat keine Berechtigung zum Konfigurieren von Remotingtypen und Channels.

Hinweise

Das zurückgegebene Proxyobjekt verweist auf einen Endpunkt, der vom angegebenen bekannten Objekt bereitgestellt wird. Es werden keine Nachrichten über das Netzwerk gesendet, bis eine Methode auf dem Proxy aufgerufen wird.

Das data Objekt wird verwendet, um Informationen an den Kanal zu kommunizieren und an die IChannelSender.CreateMessageSink Methode übergeben.

Gilt für