IpcClientChannel Класс

Определение

Реализует канал клиента для удаленных вызовов, в котором для передачи сообщений используется протокол межпроцессного взаимодействия.

public class IpcClientChannel : System.Runtime.Remoting.Channels.IChannelSender, System.Runtime.Remoting.Channels.ISecurableChannel
Наследование
IpcClientChannel
Реализации

Примеры

Приведенный ниже пример кода показывает, как использовать класс IpcClientChannel.

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

public class Client
{
    public static void Main ()
    {
        IpcClientChannel clientChannel = new IpcClientChannel();
        ChannelServices.RegisterChannel(clientChannel);

        RemotingConfiguration.RegisterWellKnownClientType( typeof(Counter) , "ipc://remote/counter" );

        Counter counter = new Counter();
        Console.WriteLine("This is call number {0}.", counter.Count);
    }
}

В предыдущем коде используется следующий удаленный объект.

using System;

public class Counter : MarshalByRefObject {

  private int count = 0;

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

Пример сервера, который удаленно предоставляет этот объект, см. в разделе IpcServerChannel.

Комментарии

Важно!

Вызов методов этого класса для ненадежных данных представляет угрозу безопасности. Вызывайте методы класса только для надежных данных. Дополнительные сведения см. в разделе "Проверка всех входных данных".

Каналы используются инфраструктурой удаленного взаимодействия the.NET Framework для передачи удаленных вызовов. Когда клиент вызывает удаленный объект, вызов сериализуется в сообщение, которое отправляется клиентским каналом и получается каналом сервера. После получения сообщения он десериализуется и обрабатывается. Все возвращаемые значения передаются каналом сервера и получаются клиентским каналом.

Класс IpcClientChannel использует систему Windows межпроцессного взаимодействия (IPC) для передачи сообщений между доменами приложений на одном компьютере. При обмене данными между доменами приложений на одном компьютере канал IPC намного быстрее, чем каналы TCP или HTTP.

Чтобы выполнить дополнительную обработку сообщений на стороне клиента, можно указать реализацию IClientChannelSinkProvider интерфейса, через который будут передаваться все сообщения, обработанные IpcClientChannel объектом.

По умолчанию IpcClientChannel класс использует двоичный модуль форматирования для сериализации всех сообщений.

Объект IpcClientChannel имеет связанные свойства конфигурации, которые можно задать во время выполнения в файле конфигурации (путем вызова статического RemotingConfiguration.Configure метода) или программным способом (путем передачи IDictionary коллекции конструктору IpcClientChannel ). Список этих свойств конфигурации см. в документации по конструктору IpcClientChannel .

Конструкторы

IpcClientChannel()

Инициализирует новый экземпляр класса IpcServerChannel.

IpcClientChannel(IDictionary, IClientChannelSinkProvider)

Инициализирует новый экземпляр класса IpcClientChannel с указанными свойствами конфигурации и приемником.

IpcClientChannel(String, IClientChannelSinkProvider)

Инициализирует новый экземпляр класса IpcClientChannel с указанным именем и приемником.

Свойства

ChannelName

Получает имя текущего канала.

ChannelPriority

Получает приоритет текущего канала.

IsSecured

Возвращает или задает логическое значение, позволяющее определить, является ли текущий канал безопасным.

Методы

CreateMessageSink(String, Object, String)

Возвращает приемник сообщений канала, который доставляет сообщения объекту данных канала или по указанному URL-адресу.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Parse(String, String)

Выделяет универсальный код ресурса (URI) канала и универсальный код ресурса (URI) известного удаленного объекта из указанного URL-адреса.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8