Compartilhar via


System.Runtime.Remoting Namespace

Fornece classes e interfaces que permitem aos desenvolvedores criar e configurar aplicativos distribuídos. Algumas das classes mais importante do namespace System.Runtime.Remoting são a classe RemotingConfiguration, a classe RemotingServices e a classe ObjRef.

Classes

ActivatedClientTypeEntry

Contém valores para um tipo de objeto registrado no lado do cliente como um tipo que pode ser ativado no servidor.

ActivatedServiceTypeEntry

Contém valores para um tipo de objeto registrado no lado do servidor como um que pode ser ativado na solicitação de um cliente.

InternalRemotingServices

Define métodos de utilitário para uso pela infraestrutura de comunicação remota do .NET Framework.

ObjectHandle

Encapsula as referências de objeto de marshaling por valor, permitindo que elas sejam retornadas por meio de uma indireção.

ObjRef

Armazena todas as informações relevantes necessárias para gerar um proxy a fim de se comunicar com um objeto remoto.

RemotingConfiguration

Fornece vários métodos estáticos para configurar a infraestrutura de comunicação remota.

RemotingException

A exceção lançada quando ocorre um erro durante a comunicação remota.

RemotingServices

Fornece vários métodos para uso e publicação de objetos remotos e proxies. Essa classe não pode ser herdada.

RemotingTimeoutException

A exceção lançada quando o servidor ou o cliente não pode ser alcançado por um período de tempo previamente especificado.

ServerException

A exceção que é gerada para comunicar erros ao cliente quando o cliente se conectar a aplicativos que não são do .NET Framework que não podem gerar exceções.

SoapServices

Fornece vários métodos para uso e publicação de objetos remotos no formato SOAP.

TypeEntry

Implementa uma classe base que contém as informações de configuração usado para ativar uma instância de um tipo remoto.

WellKnownClientTypeEntry

Contém os valores para um tipo de objeto registrado no cliente como um tipo ativado por servidor (chamada única ou singleton).

WellKnownServiceTypeEntry

Contém os valores de um tipo de objeto registrado na extremidade de serviço como um objeto de tipo ativado pelo servidor (chamada única ou singleton).

Interfaces

IChannelInfo

Fornece informações de canal personalizadas que são usadas junto com o ObjRef.

IEnvoyInfo

Fornece informações de emissário.

IObjectHandle

Define a interface para desencapsular objetos marshal-by-value de uma indireção.

IRemotingTypeInfo

Fornece informações de tipo para um objeto.

Enumerações

CustomErrorsModes

Especifica como os erros personalizados são tratados.

WellKnownObjectMode

Define como os objetos conhecidos são ativados.

Comentários

A RemotingConfiguration classe contém métodos estáticos para interfacagem com definições de configuração. O RemotingConfiguration.Configure método permite que os desenvolvedores configurem a infraestrutura de comunicação remota por meio do uso de arquivos de configuração formatados em XML. A RemotingConfiguration classe também contém vários métodos para registro de fim de cliente e servidor de objetos ativados por cliente e servidor que residem no servidor.

A RemotingServices classe fornece uma série de métodos para ajudar a usar e publicar objetos remotos. O RemotingServices.Marshal método fornece a funcionalidade para armazenar todas as informações relevantes necessárias para ativar e se comunicar com um objeto remoto em uma instância da ObjRef classe para serialização e transmissão posteriores para um local remoto. O RemotingServices.Unmarshal método inverte esse processo, criando um proxy para um objeto remoto que pode ser usado por um aplicativo sem considerar nenhuma subdivisão de comunicação remota.

A ObjRef classe contém todas as informações relevantes necessárias para ativar e se comunicar com um objeto remoto. Essa classe é uma representação serializável de um objeto que é transmitido para um local remoto usando um canal, em que é nãomarsalizado (consulte Unmarshal) e pode ser usado para criar um proxy local do objeto remoto.

Observação

Os MBRs (objetos marshal-by-reference) não residem na memória para sempre. Em vez disso, a menos que o tipo substitua MarshalByRefObject.InitializeLifetimeService para controlar suas próprias políticas de tempo de vida, cada MBR tem um tempo de vida finito antes que o sistema de comunicação remota .NET Framework inicie o processo de excluí-lo e recuperar a memória. Para obter mais informações, consulte Concessões de tempo de vida.