此示例演示如何启用 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 应用程序池才能运行。 若要创建新的应用程序池或修改默认应用程序池,请按照以下步骤操作。
-
打开“控制面板” 。 打开管理工具下的小程序系统和安全标题。 打开Internet 信息服务 (IIS) 管理器小程序。
-
展开在 treeview连接窗格。 选择应用程序池节点。
-
若要设置要使用的默认应用程序池.NET Framework 版本 4(这可能会导致与现有站点的不兼容性问题),右键单击DefaultAppPool列表项并选择基本设置... . 设置 .Net Framework 版本下拉到 .Net Framework v4.0.30128 (或更高版本)。
-
若要创建新的应用程序池使用的.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.
设置、生成和运行示例
-
若要生成 C# 或 Visual Basic .NET 版本的解决方案,请按照 Building the Windows Communication Foundation Samples中的说明进行操作。
-
解决方案生成后,运行 Setup.bat 以设置 ServiceModelSamples 应用程序在 IIS 7.0 中。 现在,ServiceModelSamples 目录应显示为 IIS 7.0 应用程序。
-
若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
