RemotingServices.Unmarshal Metode

Definisi

Ruang nama:

System.Runtime.Remoting

Rakitan:

mscorlib.dll

Mengonversi yang diberikan ObjRef menjadi objek proksi.

Overload

Unmarshal(ObjRef)	ObjRef Mengambil dan membuat objek proksi darinya.
Unmarshal(ObjRef, Boolean)	ObjRef Mengambil dan membuat objek proksi darinya, menyempurnakannya ke jenis di server.

Unmarshal(ObjRef)

ObjRef Mengambil dan membuat objek proksi darinya.

public:
 static System::Object ^ Unmarshal(System::Runtime::Remoting::ObjRef ^ objectRef);

[System.Security.SecurityCritical]
public static object Unmarshal (System.Runtime.Remoting.ObjRef objectRef);

[<System.Security.SecurityCritical>]
static member Unmarshal : System.Runtime.Remoting.ObjRef -> obj

Public Shared Function Unmarshal (objectRef As ObjRef) As Object

Parameter

objectRef

ObjRef

ObjRef yang mewakili objek jarak jauh tempat proksi sedang dibuat.

Mengembalikan

Object

Proksi ke objek yang diwakili oleh yang diberikan ObjRef .

Atribut

SecurityCriticalAttribute

Pengecualian

ArgumentException

Instans ObjRef yang ditentukan dalam objectRef parameter tidak terbentuk dengan baik.

SecurityException

Setidaknya salah satu penelepon yang lebih tinggi di tumpukan panggilan tidak memiliki izin untuk mengonfigurasi jenis jarak jauh dan saluran.

Contoh

Contoh kode berikut menunjukkan cara membatalkan amarshal objek.

ChannelServices::RegisterChannel( gcnew HttpChannel );

SampleService ^ objectSample = (SampleService^)( Activator::GetObject( SampleService::typeid,
   "http://localhost:9000/MySampleService/SampleService.soap" ) );

// The GetManuallyMarshaledObject() method uses RemotingServices::Marshal()
// to create an ObjRef object for a SampleTwo object.
ObjRef^ objRefSampleTwo = objectSample->GetManuallyMarshaledObject();

SampleTwo ^ objectSampleTwo = (SampleTwo^)( RemotingServices::Unmarshal( objRefSampleTwo ) );

objectSampleTwo->PrintMessage( "ObjRef successfuly unmarshaled." );

ChannelServices.RegisterChannel(new HttpChannel());

SampleService objectSample = (SampleService)Activator.GetObject(typeof(SampleService),
    "http://localhost:9000/MySampleService/SampleService.soap");

// The GetManuallyMarshaledObject() method uses RemotingServices.Marshal()
// to create an ObjRef object for a SampleTwo object.
ObjRef objRefSampleTwo = objectSample.GetManuallyMarshaledObject();

SampleTwo objectSampleTwo = (SampleTwo)RemotingServices.Unmarshal(objRefSampleTwo);

objectSampleTwo.PrintMessage("ObjRef successfuly unmarshaled.");

ChannelServices.RegisterChannel(New HttpChannel())

Dim objectSample As SampleService = CType(Activator.GetObject(GetType(SampleService), _ 
      "http://localhost:9000/MySampleService/SampleService.soap"), SampleService)

' The GetManuallyMarshaledObject() method uses RemotingServices.Marshal()
' to create an ObjRef object for a SampleTwo object.
Dim objRefSampleTwo As ObjRef = objectSample.GetManuallyMarshaledObject()

Dim objectSampleTwo As SampleTwo = CType(RemotingServices.Unmarshal(objRefSampleTwo), SampleTwo)

objectSampleTwo.PrintMessage("I successfully unmarshaled your ObjRef.  Thanks.")

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. Konten yang diurai ObjRef ditambahkan ke proksi transparan sebelum proksi transparan terdaftar dengan runtime bahasa umum.

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 mencapai subdivisi jarak jauh tempat objek berada.

Lihat juga

• RealProxy
• ObjRef

Unmarshal(ObjRef, Boolean)

ObjRef Mengambil dan membuat objek proksi darinya, menyempurnakannya ke jenis di server.

public:
 static System::Object ^ Unmarshal(System::Runtime::Remoting::ObjRef ^ objectRef, bool fRefine);

[System.Security.SecurityCritical]
public static object Unmarshal (System.Runtime.Remoting.ObjRef objectRef, bool fRefine);

[<System.Security.SecurityCritical>]
static member Unmarshal : System.Runtime.Remoting.ObjRef * bool -> obj

Public Shared Function Unmarshal (objectRef As ObjRef, fRefine As Boolean) As Object

Parameter

objectRef

ObjRef

ObjRef yang mewakili objek jarak jauh tempat proksi sedang dibuat.

fRefine

Boolean

true untuk menyempurnakan proksi ke jenis di server; jika tidak, false.

Mengembalikan

Object

Proksi ke objek yang diwakili oleh yang diberikan ObjRef .

Atribut

SecurityCriticalAttribute

Pengecualian

ArgumentException

Instans ObjRef yang ditentukan dalam objectRef parameter tidak terbentuk dengan baik.

SecurityException

Setidaknya salah satu penelepon yang lebih tinggi di tumpukan panggilan tidak memiliki izin untuk mengonfigurasi jenis jarak jauh dan saluran.

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. Konten yang diurai ObjRef ditambahkan ke proksi transparan sebelum proksi transparan terdaftar dengan runtime bahasa umum.

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 mencapai subdivisi jarak jauh tempat objek berada.

Ketika pertama kali dibuat, proksi berjenis MarshalByRefObject. Saat Anda mentransmisikannya ke berbagai jenis, infrastruktur jarak jauh melacak jenis yang paling banyak digunakan untuk menghindari pemuatan jenis yang tidak perlu.

Lihat juga

• RealProxy
• ObjRef