IRequestChannel.BeginRequest 方法

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

程序集:

System.ServiceModel.dll

开始一个异步操作，将请求消息传送到请求-回复消息交换的回复端。

重载

BeginRequest(Message, AsyncCallback, Object)	开始一个异步操作，将请求消息传送到请求-回复消息交换的回复端。
BeginRequest(Message, TimeSpan, AsyncCallback, Object)	开始一个异步操作，在指定时间间隔内将请求消息传送到请求-回复消息交换的回复端。

BeginRequest(Message, AsyncCallback, Object)

开始一个异步操作，将请求消息传送到请求-回复消息交换的回复端。

public:
 IAsyncResult ^ BeginRequest(System::ServiceModel::Channels::Message ^ message, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginRequest (System.ServiceModel.Channels.Message message, AsyncCallback callback, object state);

abstract member BeginRequest : System.ServiceModel.Channels.Message * AsyncCallback * obj -> IAsyncResult

Public Function BeginRequest (message As Message, callback As AsyncCallback, state As Object) As IAsyncResult

参数

message

Message

要传送的请求 Message。

callback

AsyncCallback

AsyncCallback 委托，它接收传送请求消息的异步操作的完成通知。

state

Object

一个由应用程序指定的对象，它包含与传送请求消息的异步操作关联的状态信息。

返回

IAsyncResult

引用异步消息传输的 IAsyncResult。

示例

下面的代码演示如何实现此方法。

public IAsyncResult BeginRequest(Message message,
    AsyncCallback callback, object state)
{
    return this.InnerChannel.BeginRequest(message,
        callback, state);
}

注解

如果请求消息大于使用的绑定所允许的最大消息大小，则将引发 QuotaExceededException。 最大消息大小由 MaxReceivedMessageSize 属性设置。 默认值为 65536 个字节。

BeginRequest(Message, TimeSpan, AsyncCallback, Object)

开始一个异步操作，在指定时间间隔内将请求消息传送到请求-回复消息交换的回复端。

public:
 IAsyncResult ^ BeginRequest(System::ServiceModel::Channels::Message ^ message, TimeSpan timeout, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginRequest (System.ServiceModel.Channels.Message message, TimeSpan timeout, AsyncCallback callback, object state);

abstract member BeginRequest : System.ServiceModel.Channels.Message * TimeSpan * AsyncCallback * obj -> IAsyncResult

Public Function BeginRequest (message As Message, timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult

参数

message

Message

要传送的请求 Message。

timeout

TimeSpan

指定时间间隔的 TimeSpan，在此时间间隔内必须收到响应。

callback

AsyncCallback

AsyncCallback 委托，它接收传送请求消息的异步操作的完成通知。

state

Object

一个由应用程序指定的对象，它包含与传送请求消息的异步操作关联的状态信息。

返回

IAsyncResult

引用异步消息传输的 IAsyncResult。

示例

下面的代码演示如何实现此方法：

public IAsyncResult BeginRequest(Message message,
    TimeSpan timeout, AsyncCallback callback,
    object state)
{
    return this.InnerChannel.BeginRequest(message,
        timeout, callback, state);
}

注解

如果请求消息大于使用的绑定所允许的最大消息大小，则应引发 QuotaExceededException。 最大消息大小由 MaxReceivedMessageSize 属性设置。 默认值为 65536 个字节。

如果在调用该函数时传入了 timeout，则使用该值。 如果在绑定上设置了 SendTimeout，那么，若是在调用该函数时未指定 timeout，则使用绑定上的该值。

如果在绑定上以及在调用该函数时未指定超时值，则使用 DefaultSendTimeout。 此默认值为 1 分钟。

实施者说明

如果在操作完成前超出指定的 TimeoutException，则此操作应引发 timeout。