RemotingServices.GetObjRefForProxy(MarshalByRefObject) Metode

Definisi

Ruang nama:

System.Runtime.Remoting

Rakitan:

mscorlib.dll

Mengembalikan ObjRef yang mewakili objek jarak jauh dari proksi yang ditentukan.

public:
 static System::Runtime::Remoting::ObjRef ^ GetObjRefForProxy(MarshalByRefObject ^ obj);

[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjRef GetObjRefForProxy (MarshalByRefObject obj);

[<System.Security.SecurityCritical>]
static member GetObjRefForProxy : MarshalByRefObject -> System.Runtime.Remoting.ObjRef

Public Shared Function GetObjRefForProxy (obj As MarshalByRefObject) As ObjRef

Parameter

obj

MarshalByRefObject

Proksi yang tersambung ke objek yang ingin Anda buat ObjRef .

Mengembalikan

ObjRef

ObjRef yang mewakili objek jarak jauh yang terhubung dengan proksi yang ditentukan, atau null jika objek atau proksi belum di-marshal.

Atribut

SecurityCriticalAttribute

Pengecualian

SecurityException

Pemanggil langsung tidak memiliki izin infrastruktur.

Contoh

Contoh kode berikut menunjukkan cara mendapatkan ObjRef instans untuk objek yang ditentukan.

ObjRef^ objRefSample = RemotingServices::GetObjRefForProxy( myRemoteObject );
Console::WriteLine( "***ObjRef Details***" );
Console::WriteLine( "URI:\t {0}", objRefSample->URI );
array<Object^>^channelData = objRefSample->ChannelInfo->ChannelData;
Console::WriteLine( "Channel Info:" );
IEnumerator^ myEnum = channelData->GetEnumerator();
while ( myEnum->MoveNext() )
{
   Object^ o = safe_cast<Object^>(myEnum->Current);
   Console::WriteLine( "\t {0}", o );
}

IEnvoyInfo^ envoyInfo = objRefSample->EnvoyInfo;
if ( envoyInfo == nullptr )
{
   Console::WriteLine( "This ObjRef does not have envoy information." );
}
else
{
   IMessageSink^ envoySinks = envoyInfo->EnvoySinks;
   Console::WriteLine( "Envoy Sink Class: {0}", envoySinks );
}

IRemotingTypeInfo^ typeInfo = objRefSample->TypeInfo;
Console::WriteLine( "Remote type name: {0}", typeInfo->TypeName );
Console::WriteLine( "Can my Object* cast to a Bitmap? {0}", typeInfo->CanCastTo( System::Drawing::Bitmap::typeid, objRefSample ) );

ObjRef objRefSample = RemotingServices.GetObjRefForProxy(myRemoteObject);

Console.WriteLine("***ObjRef Details***");
Console.WriteLine("URI:\t{0}", objRefSample.URI);

object[] channelData = objRefSample.ChannelInfo.ChannelData;

Console.WriteLine("Channel Info:");
foreach(object o in channelData)
    Console.WriteLine("\t{0}", o.ToString());

IEnvoyInfo envoyInfo = objRefSample.EnvoyInfo;

if (envoyInfo == null) {
    Console.WriteLine("This ObjRef does not have envoy information.");
}
else {
    IMessageSink envoySinks = envoyInfo.EnvoySinks;
    Console.WriteLine("Envoy Sink Class: {0}", envoySinks);
}

IRemotingTypeInfo typeInfo = objRefSample.TypeInfo;
Console.WriteLine("Remote type name: {0}", typeInfo.TypeName);

Console.WriteLine("Can my object cast to a Bitmap? {0}",
    typeInfo.CanCastTo(typeof(System.Drawing.Bitmap), objRefSample));

Dim objRefSample As ObjRef = RemotingServices.GetObjRefForProxy(myRemoteObject)

Console.WriteLine("***ObjRef Details***")
Console.WriteLine("URI:" + ControlChars.Tab + "{0}", objRefSample.URI)

Dim channelData As Object() = objRefSample.ChannelInfo.ChannelData
Console.WriteLine("Channel Info:")

Dim o As Object
For Each o In  channelData
   Console.WriteLine(ControlChars.Tab + "{0}", o.ToString())
Next o

Dim envoyInfo As IEnvoyInfo = objRefSample.EnvoyInfo
If envoyInfo Is Nothing Then
   Console.WriteLine("This ObjRef does not have envoy information.")
Else
   Dim envoySinks As IMessageSink = envoyInfo.EnvoySinks
   Console.WriteLine("Envoy Sink Class: {0}", envoySinks)
End If

Dim typeInfo As IRemotingTypeInfo = objRefSample.TypeInfo
Console.WriteLine("Remote type name: {0}", typeInfo.TypeName)

Console.WriteLine("Can my object cast to a Bitmap? {0}", typeInfo.CanCastTo(GetType(System.Drawing.Bitmap), objRefSample))

Keterangan

ObjRef adalah representasi objek yang dapat diserialisasikan yang digunakan untuk mentransfer referensi objek di seluruh batas domain aplikasi. ObjRef Membuat untuk objek dikenal sebagai marshaling. ObjRef dapat ditransfer melalui saluran ke domain aplikasi lain (mungkin pada proses atau komputer lain). Setelah berada di domain aplikasi lain, ObjRef harus diurai untuk membuat proksi untuk objek, umumnya terhubung ke objek nyata. Operasi ini dikenal sebagai unmarshaling. Selama unmarshaling, ObjRef diurai untuk mengekstrak informasi metode objek jarak jauh dan proksi RealProxy dan objek transparan dibuat.

ObjRef berisi informasi yang menjelaskan Type kelas dan objek yang di-marshal, URI yang secara unik mengidentifikasi instans objek tertentu, dan informasi terkait komunikasi tentang cara menjangkau aplikasi jarak jauh tempat objek berada.