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

ASP.NET 兼容性

· 52CE 我爱测

此示例演示如何启用 ASP.NET 兼容性模式在 Windows Communication Foundation (WCF)。 在 ASP.NET 兼容性模式完全参与 ASP.NET 应用程序管道,并可以使运行的服务使用的 ASP.NET 功能,如文件 /URL 授权、 会话状态和类。 类可以访问 cookie、 会话和其他 ASP.NET 功能。 此模式要求绑定使用 HTTP 传输,且服务本身必须承载于 IIS 中。

此示例演示如何启用 ASP.NET 兼容性模式在 Windows Communication Foundation (WCF)。 在 ASP.NET 兼容性模式完全参与 ASP.NET 应用程序管道,并可以使运行的服务使用的 ASP.NET 功能,如文件 /URL 授权、 会话状态和xref:System.Web.HttpContext类。 xref:System.Web.HttpContext类可以访问 cookie、 会话和其他 ASP.NET 功能。 此模式要求绑定使用 HTTP 传输,且服务本身必须承载于 IIS 中。

在此示例中,客户端是一个控制台应用程序(一个可执行文件),服务由 Internet 信息服务 (IIS) 承载。

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

此示例需要 .NET Framework 版本 4 应用程序池才能运行。 若要创建新的应用程序池或修改默认应用程序池,请按照以下步骤操作。

  1. 打开“控制面板” 。 打开管理工具下的小程序系统和安全标题。 打开Internet 信息服务 (IIS) 管理器小程序。

  2. 展开在 treeview连接窗格。 选择应用程序池节点。

  3. 若要设置要使用的默认应用程序池.NET Framework 版本 4(这可能会导致与现有站点的不兼容性问题),右键单击DefaultAppPool列表项并选择基本设置... . 设置 .Net Framework 版本下拉到 .Net Framework v4.0.30128 (或更高版本)。

  4. 若要创建新的应用程序池使用的.NET Framework 版本 4(若要保持其他应用程序兼容性),右键单击应用程序池节点,然后选择添加应用程序池... . 命名新的应用程序池,并将设置 .Net Framework 版本下拉到 .Net Framework v4.0.30128 (或更高版本)。 运行安装程序下面的步骤后,右键单击ServiceModelSamples应用程序并选择管理应用程序,高级设置... . 设置应用程序池到新的应用程序池。

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\Services\Hosting\WebHost\ASPNetCompatibility

此示例基于Getting Started,它可实现计算器服务。 ICalculator 协定已根据 ICalculatorSession 协定进行修改,允许在保持运行结果的同时执行一组运算。

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
public interface ICalculatorSession  
{  
    [OperationContract]  
    void Clear();  
    [OperationContract]  
    void AddTo(double n);  
    [OperationContract]  
    void SubtractFrom(double n);  
    [OperationContract]  
    void MultiplyBy(double n);  
    [OperationContract]  
    void DivideBy(double n);  
    [OperationContract]  
    double Result();  
}  

在调用多个服务操作来执行计算时,服务将使用该功能保持每个客户端的状态。 客户端可以通过调用 Result 来检索当前结果,通过调用 Clear 将结果清零。

服务使用 ASP.NET 会话来将结果存储为每个客户端会话。 这使服务可以为跨多个服务调用的每个客户端保持运行结果。

Note: ASP.NET 会话状态和 WCF 会话是截然不同的事物。 请参阅会话有关 WCF 会话的详细信息。

该服务直接依赖对 ASP.NET 会话状态,并需要 ASP.NET 兼容性模式才能正常工作。 这些需求是通过应用 AspNetCompatibilityRequirements 属性以声明性方式表示的。

[AspNetCompatibilityRequirements(RequirementsMode =  
                       AspNetCompatibilityRequirementsMode.Required)]  
public class CalculatorService : ICalculatorSession  
{  
    double Result  
    {  // store result in AspNet Session  
       get {  
          if (HttpContext.Current.Session["Result"] != null)  
             return (double)HttpContext.Current.Session["Result"];  
          return 0.0D;  
       }  
       set  
       {  
          HttpContext.Current.Session["Result"] = value;  
       }  
    }  
    public void Clear()  
    {  
        Result = 0.0D;  
    }  
    public void AddTo(double n)  
    {  
        Result += n;  
    }  
    public void SubtractFrom(double n)  
    {  
        Result -= n;  
    }  
    public void MultiplyBy(double n)  
    {  
        Result *= n;  
    }  
    public void DivideBy(double n)  
    {  
        Result /= n;  
    }  
    public double Result()  
    {  
        return Result;  
    }  
}  

运行示例时,操作请求和响应将显示在客户端控制台窗口中。 在客户端窗口中按 Enter 可以关闭客户端。

0, + 100, - 50, * 17.65, / 2 = 441.25  
Press <ENTER> to terminate client.  

设置、生成和运行示例

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

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

  3. 解决方案生成后,运行 Setup.bat 以设置 ServiceModelSamples 应用程序在 IIS 7.0 中。 现在,ServiceModelSamples 目录应显示为 IIS 7.0 应用程序。

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

请参阅

历史资料。此文对应 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(示例代码)

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

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