RemotingServices.Unmarshal Método

Definição

Espaço de Nomes:: System.Runtime.Remoting

Assemblagem:: mscorlib.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Converte um dado ObjRef num objeto proxy.

Sobrecargas

Name	Description
Unmarshal(ObjRef)	Tira um ObjRef e cria um objeto proxy a partir dele.
Unmarshal(ObjRef, Boolean)	Pega num ObjRef e cria um objeto proxy a partir dele, refinando-o para o tipo no servidor.

Unmarshal(ObjRef)

Tira um ObjRef e cria um objeto proxy a partir dele.

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

public static object Unmarshal(System.Runtime.Remoting.ObjRef objectRef);

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

static member Unmarshal : System.Runtime.Remoting.ObjRef -> obj

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

Public Shared Function Unmarshal (objectRef As ObjRef) As Object

Parâmetros

objectRef: ObjRef

O ObjRef que representa o objeto remoto para o qual o proxy está a ser criado.

Devoluções

Object

Um proxy do objeto que o dado ObjRef representa.

Atributos: SecurityCriticalAttribute

Exceções

ArgumentException

A ObjRef instância especificada no objectRef parâmetro não está bem formada.

SecurityException

Pelo menos um dos chamadores mais acima na pilha de chamadas não tem permissão para configurar tipos e canais de remoto.

Exemplos

O seguinte exemplo de código demonstra como desorganizar o marshal de um objeto.

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.")

Observações

A ObjRef é uma representação serializável de um objeto usada para transferir uma referência de objeto através de um limite de domínio de aplicação. Criar um ObjRef para um objeto é conhecido como marshaling. Podem ObjRef ser transferidos através de um canal para outro domínio de aplicação (possivelmente noutro processo ou computador). Uma vez no outro domínio de aplicação, o ObjRef deve ser analisado para criar um proxy para o objeto, geralmente ligado ao objeto real. Esta operação é conhecida como unmarshaling. Durante o unmarshaling, o ObjRef é analisado para extrair a informação do método do objeto remoto e tanto o proxy transparente como RealProxy os objetos são criados. O conteúdo do parsed ObjRef é adicionado ao proxy transparente antes de este ser registado no runtime da linguagem comum.

A contém informação que descreve a ObjRef classe e do objeto a ser marshaleado, um URI que identifica de forma única a instância específica do objeto, e informações relacionadas com Type comunicação sobre como chegar à subdivisão remota onde o objeto está localizado.

Ver também

Aplica-se a

Unmarshal(ObjRef, Boolean)

Pega num ObjRef e cria um objeto proxy a partir dele, refinando-o para o tipo no servidor.

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

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

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

static member Unmarshal : System.Runtime.Remoting.ObjRef * bool -> obj

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

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