System.Runtime.Remoting.Messaging Пространство имен
Содержит классы, используемые для создания и передачи сообщений. Contains classes used to create and transmit messages. Инфраструктура удаленного взаимодействия основана на использовании сообщений для работы с удаленными объектами. The remoting infrastructure uses messages to communicate with remote objects. Сообщения используются для передачи вызовов удаленных методов, активации удаленных объектов и передачи данных. Messages are used to transmit remote method calls, to activate remote objects, and to communicate information. Объект сообщения содержит список именованных свойств, таких как идентификаторы действий, посылаемые данные и параметры. A message object carries a set of named properties, including action identifiers, envoy information, and parameters. Одними из важнейших классов пространства имен System.Runtime.Remoting.Messaging являются классы AsyncResult, RemotingSurrogateSelector и ReturnMessage. Some of the most important classes of the System.Runtime.Remoting.Messaging namespace are the AsyncResult class, the RemotingSurrogateSelector class, and the ReturnMessage class.
Классы
| AsyncResult |
Инкапсулирует результаты асинхронной операции на делегате.Encapsulates the results of an asynchronous operation on a delegate. |
| CallContext |
Предоставляет набор свойств, которые переносятся с помощью выполняемой ветви кода.Provides a set of properties that are carried with the execution code path. Этот класс не наследуется.This class cannot be inherited. |
| ConstructionCall |
Реализует интерфейс IConstructionCallMessage для создания сообщения запроса, представляющего собой вызов конструктора удаленного объекта.Implements the IConstructionCallMessage interface to create a request message that constitutes a constructor call on a remote object. |
| ConstructionResponse |
Реализует интерфейс IConstructionReturnMessage для создания сообщения, отвечающего на вызов для создания экземпляра удаленного объекта.Implements the IConstructionReturnMessage interface to create a message that responds to a call to instantiate a remote object. |
| Header |
Определяет экстренные данные для вызова.Defines the out-of-band data for a call. |
| InternalMessageWrapper |
Создает оболочку для передачи данных удаленного взаимодействия между приемниками сообщений, либо для запросов от клиента к серверу, либо для последующих ответов.Wraps remoting data for passing between message sinks, either for requests from client to server or for the subsequent responses. |
| LogicalCallContext |
Предоставляет набор свойств, которые переносятся с помощью выполняемой ветви кода во время вызовов удаленных методов.Provides a set of properties that are carried with the execution code path during remote method calls. |
| MethodCall |
Реализует интерфейс IMethodCallMessage для создания сообщения запроса, действующего как вызов метода для удаленного объекта.Implements the IMethodCallMessage interface to create a request message that acts as a method call on a remote object. |
| MethodCallMessageWrapper |
Реализует интерфейс IMethodCallMessage для создания сообщения запроса, действующего как вызов метода для удаленного объекта.Implements the IMethodCallMessage interface to create a request message that acts as a method call on a remote object. |
| MethodResponse |
Реализует интерфейс IMethodReturnMessage для создания сообщения, действующего как ответ метода для удаленного объекта.Implements the IMethodReturnMessage interface to create a message that acts as a method response on a remote object. |
| MethodReturnMessageWrapper |
Реализует интерфейс IMethodReturnMessage для создания сообщения, действующего как ответ на вызов метода удаленного объекта.Implements the IMethodReturnMessage interface to create a message that acts as a response to a method call on a remote object. |
| OneWayAttribute |
Помечает метод как односторонний без возвращаемого значения и параметров |
| RemotingSurrogateSelector |
Выбирает суррогат удаленного взаимодействия, используемый для сериализации объекта, производного от MarshalByRefObject.Selects the remoting surrogate that can be used to serialize an object that derives from a MarshalByRefObject. |
| ReturnMessage |
Содержит сообщение, возвращенное в ответ на вызов метода для удаленного объекта.Holds a message returned in response to a method call on a remote object. |
Интерфейсы
| ILogicalThreadAffinative |
Помечает объект, который может распространяться вне AppDomain в LogicalCallContext.Marks an object that can propagate outside of an AppDomain in a LogicalCallContext. |
| IMessage |
Содержит данные о связи, передаваемые между объединенными приемниками сообщений.Contains communication data sent between cooperating message sinks. |
| IMessageCtrl |
Предоставляет способ управления асинхронными сообщениями после их отправки с помощью AsyncProcessMessage(IMessage, IMessageSink).Provides a way to control asynchronous messages after they have dispatched using the AsyncProcessMessage(IMessage, IMessageSink). |
| IMessageSink |
Определяет интерфейс для приемника сообщений.Defines the interface for a message sink. |
| IMethodCallMessage |
Определяет интерфейс сообщения о вызове метода.Defines the method call message interface. |
| IMethodMessage |
Определяет интерфейс сообщения метода.Defines the method message interface. |
| IMethodReturnMessage |
Определяет интерфейс возвращаемого сообщения о вызове метода.Defines the method call return message interface. |
| IRemotingFormatter |
Предоставляет интерфейс удаленного вызова процедур (RPC) для всех модулей форматирования.Provides the remote procedure call (RPC) interface for all formatters. |
Делегаты
| HeaderHandler |
Представляет метод для обработки заголовков в потоке при десериализации.Represents the method that will handle processing of headers on the stream during deserialization. |
| MessageSurrogateFilter |
Определяет, должен ли класс RemotingSurrogateSelector игнорировать конкретное свойство IMessage при создании ObjRef для класса MarshalByRefObject.Determines whether the RemotingSurrogateSelector class should ignore a particular IMessage property while creating an ObjRef for a MarshalByRefObject class. |
Комментарии
AsyncResultКласс сохраняет и возвращает результаты вызова асинхронного метода.The AsyncResult class stores and returns the results of an asynchronous method call. AsyncResult экземпляры содержат return значение, состояние вызова, делегат, используемый для вызова, и другие сведения о асинхронном вызове метода.AsyncResult instances contain the return value, call status, the delegate used for the call, and the other information about the asynchronous method call.
RemotingSurrogateSelectorКласс можно использовать для управления сериализацией объектов, которые расширяют MarshalByRefObject .The RemotingSurrogateSelector class can be used to control serialization of objects that extend MarshalByRefObject. Объект RemotingSurrogateSelector выбирает суррогат, используемый для сериализации и десериализации таких объектов.A RemotingSurrogateSelector selects the surrogate used in serialization and deserialization of such objects. Суррогат — это объект, который может управлять сериализацией или десериализацией объекта.A surrogate is an object that can control serialization or deserialization of an object.
ReturnMessageКласс содержит сведения, возвращаемые после удаленного вызова метода.The ReturnMessage class holds information returned after a remote method call. Объект ReturnMessage содержит return значение, а также out любые ref Параметры или, которые привели к удаленному вызову метода.A ReturnMessage holds the return value and any out or ref parameters that resulted from the remote method call.