大网数据广告活动
.NET 与 C# 开发

单向

· 52CE 我爱测

此示例演示具有单向服务操作的服务协定。 客户端不会像在双向服务操作中那样等待服务操作完成。 此示例基于Getting Started ,并使用wsHttpBinding绑定。 此示例中的服务是自承载控制台应用程序,通过它可以观察接收和处理请求的服务。 客户端也是一个控制台应用程序。

此示例演示具有单向服务操作的服务协定。 客户端不会像在双向服务操作中那样等待服务操作完成。 此示例基于Getting Started ,并使用wsHttpBinding绑定。 此示例中的服务是自承载控制台应用程序,通过它可以观察接收和处理请求的服务。 客户端也是一个控制台应用程序。

Note: 本主题的最后介绍了此示例的设置过程和生成说明。

若要创建单向服务协定,请定义服务协定,将 xref:System.ServiceModel.OperationContractAttribute 类应用于每个操作,并将 xref:System.ServiceModel.OperationContractAttribute.IsOneWay* 设置为 true,如下面的示例代码所示:

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
public interface IOneWayCalculator  
{  
    [OperationContract(IsOneWay=true)]  
    void Add(double n1, double n2);  
    [OperationContract(IsOneWay = true)]  
    void Subtract(double n1, double n2);  
    [OperationContract(IsOneWay = true)]  
    void Multiply(double n1, double n2);  
    [OperationContract(IsOneWay = true)]  
    void Divide(double n1, double n2);  
}  

为了演示客户端不会等待服务操作完成,此示例中的服务代码实现了五秒钟的延迟,如下面的示例代码所示:

// This service class implements the service contract.  
// This code writes output to the console window.  
 [ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple,  
    InstanceContextMode = InstanceContextMode.PerCall)]  
public class CalculatorService : IOneWayCalculator  
{  
    public void Add(double n1, double n2)  
    {  
        Console.WriteLine("Received Add({0},{1}) - sleeping", n1, n2);  
        System.Threading.Thread.Sleep(1000 * 5);  
        double result = n1 + n2;  
        Console.WriteLine("Processing Add({0},{1}) - result: {2}", n1, n2, result);  
    }  
    ...  
}  

当客户端调用服务时,调用不等待服务操作完成即返回。

运行示例时,客户端和服务活动将显示在服务和客户端控制台窗口中。 您可以看到服务从客户端接收消息。 在每个控制台窗口中按 Enter 可以同时关闭服务和客户端。

客户端在服务之前完成,说明了客户端没有等待单向服务操作完成。 客户端输出如下所示:

Add(100,15.99)  
Subtract(145,76.54)  
Multiply(9,81.25)  
Divide(22,7)  
  
Press <ENTER> to terminate client.  

服务输出如下所示:

The service is ready.  
Press <ENTER> to terminate service.  
  
Received Add(100,15.99) - sleeping  
Received Subtract(145,76.54) - sleeping  
Received Multiply(9,81.25) - sleeping  
Received Divide(22,7) - sleeping  
Processing Add(100,15.99) - result: 115.99  
Processing Subtract(145,76.54) - result: 68.46  
Processing Multiply(9,81.25) - result: 731.25  
Processing Divide(22,7) - result: 3.14285714285714  

Note: HTTP 从定义上讲是一个请求/响应协议;当发出请求时,即返回响应。 即使对于通过 HTTP 公开的单向服务操作,也是如此。 当调用操作时,服务在执行服务操作之前返回 HTTP 状态码 202。 此状态码表示请求已被接受进行处理,但处理尚未完成。 调用操作的客户端在从服务收到 202 响应之前处于阻止状态。 当使用绑定(配置为使用会话)发送多个单向消息时,这可能会产生某些意外行为。 此示例中使用的 wsHttpBinding 绑定配置为默认使用会话来建立安全上下文。 默认情况下,会话中的消息一定会按照它们的发送顺序到达。 因此,当发送会话中的第二个消息时,在处理完第一个消息之前不会处理第二个消息。 这样的结果是,在处理完上一个消息之前,客户端不会收到消息的 202 响应。 因此,客户端似乎是阻止了每个后续的操作调用。 为了避免此行为,此示例对运行库进行了配置,以便将消息并发调度给不同的实例进行处理。 本示例将 xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode* 设置为 PerCall,以使每条消息可以由不同的实例来处理。 xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode* 设置为 Multiple,以允许多个线程同时调度消息。

设置、生成和运行示例

  1. 请确保您具有执行的 Windows Communication Foundation 示例的一次性安装过程。

  2. 若要生成 C# 或 Visual Basic .NET 版本的解决方案,请按照 Building the Windows Communication Foundation Samples中的说明进行操作。

  3. 若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。

Note: 请在运行客户端之前运行服务,并在关闭服务之前关闭客户端。 这样可以避免当客户端由于服务已关闭而无法彻底关闭安全会话时出现客户端异常。

Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:

<InstallDrive>:\WF_WCF_Samples

如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:

<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Oneway

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。