IpcServerChannel Classe

Definição

Namespace:

System.Runtime.Remoting.Channels.Ipc

Assembly:

System.Runtime.Remoting.dll

Implementa um canal de servidor para chamadas remotas, que usa o sistema IPC para transmitir mensagens.

public ref class IpcServerChannel : System::Runtime::Remoting::Channels::IChannelReceiver, System::Runtime::Remoting::Channels::ISecurableChannel

public class IpcServerChannel : System.Runtime.Remoting.Channels.IChannelReceiver, System.Runtime.Remoting.Channels.ISecurableChannel

type IpcServerChannel = class
    interface IChannelReceiver
    interface IChannel
    interface ISecurableChannel

Public Class IpcServerChannel
Implements IChannelReceiver, ISecurableChannel

Herança

Object

IpcServerChannel

Implementações

IChannel IChannelReceiver ISecurableChannel

Exemplos

O exemplo de código a seguir ilustra como usar a IpcServerChannel classe.

#using <system.runtime.remoting.dll>
#using <System.dll>
#using <Counter.dll>

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Ipc;

public ref class IpcServer
{
public:
   void IpcServerTest()
   {
      // Create and register an IPC channel
      IpcServerChannel^ serverChannel = gcnew IpcServerChannel( L"remote" );
      ChannelServices::RegisterChannel( serverChannel );

      // Expose an object
      RemotingConfiguration::RegisterWellKnownServiceType( Counter::typeid, L"counter", WellKnownObjectMode::Singleton );
      
      // Wait for calls
      Console::WriteLine( L"Listening on {0}", serverChannel->GetChannelUri() );

      Console::ReadLine();
   }
};

int main()
{
   IpcServer^ is = gcnew IpcServer;
   is->IpcServerTest();
}

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Ipc;

public class IpcServer
{

    public static void Main ()
    {
        // Create and register an IPC channel
        IpcServerChannel serverChannel = new IpcServerChannel("remote");
        ChannelServices.RegisterChannel(serverChannel);

        // Expose an object
        RemotingConfiguration.RegisterWellKnownServiceType( typeof(Counter), "counter", WellKnownObjectMode.Singleton );

        // Wait for calls
        Console.WriteLine("Listening on {0}", serverChannel.GetChannelUri());
        Console.ReadLine();
    }
}

O código anterior é usado para expor o seguinte objeto remoto.

using namespace System;
public ref class Counter: public MarshalByRefObject
{
private:
   int count;

public:
   Counter()
   {
      count = 0;
   }

   property int Count 
   {
      int get()
      {
         return (count)++;
      }
   }
};

using System;

public class Counter : MarshalByRefObject {

  private int count = 0;

  public int Count { get {
    return(count++);
  } }
}

Para obter um exemplo de um cliente que usa esse objeto remotamente, consulte IpcClientChannel.

Comentários

Importante

Chamar métodos desta classe quando você tiver dados não confiáveis é um risco à segurança. Chame os métodos dessa classe somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar Todas as Entradas.

Os canais são usados pela infraestrutura de comunicação remota .NET Framework para transportar chamadas remotas. Quando um cliente chama um objeto remoto, a chamada é serializada em uma mensagem enviada por um canal cliente e recebida por um canal de servidor. Depois que a mensagem é recebida, ela é desserializada e processada. Todos os valores retornados são transmitidos pelo canal do servidor e recebidos pelo canal cliente.

A IpcServerChannel classe usa o sistema Windows comunicação entre processos (IPC) para transportar mensagens entre domínios de aplicativo no mesmo computador. Ao se comunicar entre domínios de aplicativo no mesmo computador, o canal IPC é muito mais rápido do que os canais TCP ou HTTP.

Para executar o processamento adicional de mensagens no lado do servidor, especifique uma implementação da interface por meio da IServerChannelSinkProvider qual todas as mensagens processadas pela IpcServerChannel instância são passadas.

A IpcServerChannel instância aceita mensagens serializadas no formato binário ou SOAP.

Um IpcServerChannel objeto tem propriedades de configuração associadas que podem ser definidas em tempo de execução em um arquivo de configuração (invocando o método estático RemotingConfiguration.Configure ) ou programaticamente (passando uma IDictionary coleção para o IpcServerChannel construtor). Para obter uma lista dessas propriedades de configuração, consulte a documentação do IpcServerChannel construtor.

Cuidado

Ao definir a exclusiveAddressUse propriedade false no properties argumento, vários IpcServerChannel objetos podem ser registrados para o mesmo pipe nomeado. Nesse caso, as solicitações podem ir para qualquer um dos canais registrados. Essa configuração será considerada segura somente se as ALCs também forem usadas.

Construtores

IpcServerChannel(IDictionary, IServerChannelSinkProvider)	Inicializa uma nova instância da classe IpcServerChannel com as propriedades de canal e os coletores especificados.
IpcServerChannel(IDictionary, IServerChannelSinkProvider, CommonSecurityDescriptor)	Inicializa uma nova instância da classe IpcServerChannel com propriedades de canal, coletor e descritor de segurança especificados.
IpcServerChannel(String)	Inicializa uma nova instância da classe IpcServerChannel com o nome da porta IPC especificado.
IpcServerChannel(String, String)	Inicializa uma nova instância da classe IpcServerChannel com o nome do canal e o nome da porta IPC especificados.
IpcServerChannel(String, String, IServerChannelSinkProvider)	Inicializa uma nova instância da classe IpcServerChannel com o nome do canal, o nome da porta IPC e o coletor especificados.

Propriedades

ChannelData	Obtém dados específicos do canal.
ChannelName	Obtém o nome do canal atual.
ChannelPriority	Obtém a prioridade do canal atual.
IsSecured	Obtém ou define um valor booliano que indica se o canal atual é seguro.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetChannelUri()	Retorna o URI do canal atual.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUrlsForUri(String)	Retorna uma matriz de todas as URLs para o objeto com o URI especificado, hospedado na instância IpcChannel atual.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Parse(String, String)	Extrai o URI do canal e o URI do objeto bem conhecido remoto da URL especificada.
StartListening(Object)	Instrui o canal atual a iniciar a escuta de solicitações.
StopListening(Object)	Instrui o canal atual a parar de escutar solicitações.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)