System.Runtime.Remoting Namespace

O namespace System.Runtime.Remoting fornece classes e interfaces que permitem aos desenvolvedores criar e configurar aplicativos distribuídos. The System.Runtime.Remoting namespace provides classes and interfaces that allow developers to create and configure distributed applications. Algumas das classes mais importante do namespace System.Runtime.Remoting são a classe RemotingConfiguration, a classe RemotingServices e a classe ObjRef. Some of the more important classes of the System.Runtime.Remoting namespace are the RemotingConfiguration class, the RemotingServices class, and the ObjRef class.

Classes

ActivatedClientTypeEntry

Contém valores para um tipo de objeto registrado no lado do cliente como um tipo que pode ser ativado no servidor.Holds values for an object type registered on the client end as a type that can be activated on the server.

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.Holds values for an object type registered on the service end as one that can be activated on request from a client.

InternalRemotingServices

Define métodos de utilitário para uso pela infraestrutura de comunicação remota do .NET Framework.Defines utility methods for use by the .NET Framework remoting infrastructure.

ObjectHandle

Encapsula as referências de objeto de marshaling por valor, permitindo que elas sejam retornadas por meio de uma indireção.Wraps marshal-by-value object references, allowing them to be returned through an indirection.

ObjRef

Armazena todas as informações relevantes necessárias para gerar um proxy a fim de se comunicar com um objeto remoto.Stores all relevant information required to generate a proxy in order to communicate with a remote object.

RemotingConfiguration

Fornece vários métodos estáticos para configurar a infraestrutura de comunicação remota.Provides various static methods for configuring the remoting infrastructure.

RemotingException

A exceção lançada quando ocorre um erro durante a comunicação remota.The exception that is thrown when something has gone wrong during remoting.

RemotingServices

Fornece vários métodos para uso e publicação de objetos remotos e proxies.Provides several methods for using and publishing remoted objects and proxies. Essa classe não pode ser herdada.This class cannot be inherited.

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.The exception that is thrown when the server or the client cannot be reached for a previously specified period of time.

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.The exception that is thrown to communicate errors to the client when the client connects to non-.NET Framework applications that cannot throw exceptions.

SoapServices

Fornece vários métodos para uso e publicação de objetos remotos no formato SOAP.Provides several methods for using and publishing remoted objects in SOAP format.

TypeEntry

Implementa uma classe base que contém as informações de configuração usado para ativar uma instância de um tipo remoto.Implements a base class that holds the configuration information used to activate an instance of a remote type.

WellKnownClientTypeEntry

Contém os valores para um tipo de objeto registrado no cliente como um tipo ativado por servidor (chamada única ou singleton).Holds values for an object type registered on the client as a server-activated type (single call or 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).Holds values for an object type registered on the service end as a server-activated type object (single call or singleton).

Interfaces

IChannelInfo

Fornece informações de canal personalizadas que são usadas junto com o ObjRef.Provides custom channel information that is carried along with the ObjRef.

IEnvoyInfo

Fornece informações de emissário.Provides envoy information.

IObjectHandle

Define a interface para desencapsular objetos marshal-by-value de uma indireção.Defines the interface for unwrapping marshal-by-value objects from indirection.

IRemotingTypeInfo

Fornece informações de tipo para um objeto.Provides type information for an object.

Enumerações

CustomErrorsModes

Especifica como os erros personalizados são tratados.Specifies how custom errors are handled.

WellKnownObjectMode

Define como os objetos conhecidos são ativados.Defines how well-known objects are activated.

Comentários

O RemotingConfiguration classe contém métodos estáticos para fazer interface com as definições de configuração.The RemotingConfiguration class contains static methods for interfacing with configuration settings. O RemotingConfiguration.Configure método permite que os desenvolvedores configurem a infraestrutura de comunicação remota com o uso de arquivos de configuração XML formatado.The RemotingConfiguration.Configure method allows developers to configure the remoting infrastructure through the use of XML formatted configuration files. O RemotingConfiguration classe também contém vários métodos para registro do lado do cliente e servidor-end do cliente e servidor ativado objetos que residem no servidor.The RemotingConfiguration class also contains several methods for client-end and server-end registration of client and server activated objects that reside on the server.

O RemotingServices classe fornece vários métodos para ajudar em uso e publicação de objetos remotos.The RemotingServices class provides a number of methods to help in using and publishing remoted objects. O RemotingServices.Marshal método fornece a funcionalidade para armazenar todas as informações relevantes necessárias para ativar e comunicar-se com um objeto remoto em uma instância da ObjRef classe para serialização posterior e a transmissão para um local remoto.The RemotingServices.Marshal method provides the functionality for storing all the relevant information required to activate and communicate with a remote object in an instance of the ObjRef class for later serialization and transmission to a remote location. O RemotingServices.Unmarshal método reverte esse processo, criando um proxy para um objeto remoto que pode ser usado por um aplicativo sem levar em consideração qualquer subdivisões de comunicação remota.The RemotingServices.Unmarshal method reverses this process, creating a proxy for a remote object that can be used by an application without regard for any remoting subdivisions.

O ObjRef classe contém todas as informações relevantes necessárias para ativar e comunicar-se com um objeto remoto.The ObjRef class holds all the relevant information required to activate and communicate with a remote object. Essa classe é uma representação serializável de um objeto que é transmitida para um local remoto usando um canal, em que ele é desempacotado (consulte Unmarshal) e pode ser usado para criar um proxy local do objeto remoto.This class is a serializable representation of an object that is transmitted to a remote location using a channel, where it is unmarshaled (see Unmarshal) and can be used to create a local proxy of the remoted object.

Observação

Objetos de marshaling por referência (MBRs) não residem na memória para sempre.Marshal-by-reference objects (MBRs) do not reside in memory forever. Em vez disso, a menos que o tipo substitui MarshalByRefObject.InitializeLifetimeService para controlar suas próprias diretivas de tempo de vida, cada MBR tem um tempo de vida finito antes que o sistema de comunicação remota do .NET Framework começa o processo de excluí-lo e recuperar a memória.Instead, unless the type overrides MarshalByRefObject.InitializeLifetimeService to control its own lifetime policies, each MBR has a finite lifetime before the .NET Framework remoting system begins the process of deleting it and reclaiming the memory. Para obter mais informações, consulte concessões de tempo de vida.For more information, see Lifetime Leases.