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

从开发的角度比较 ASP.NET Web 服务与 WCF

· 52CE 我爱测

Windows Communication Foundation (WCF) 提供用于启用 WCF 应用程序进行编程和配置类似于 ASP.NET Web 服务,并模拟其行为的 ASP.NET 兼容模式选项。 以下部分进行了比较 ASP.NET Web 服务和 WCF 基于使用这两种技术开发应用程序的要求。

Windows Communication Foundation (WCF) 提供用于启用 WCF 应用程序进行编程和配置类似于 ASP.NET Web 服务,并模拟其行为的 ASP.NET 兼容模式选项。 以下部分进行了比较 ASP.NET Web 服务和 WCF 基于使用这两种技术开发应用程序的要求。

数据表示形式

一般情况下,使用 ASP.NET 开发 Web 服务首先要定义服务要使用的任意复杂数据类型。 ASP.NET 依赖于 xref:System.Xml.Serialization.XmlSerializer 将由 .NET Framework 类型表示的数据转换为 XML,以便与服务进行相互传输并将以 XML 形式接收的数据转换为 .NET Framework 对象。 定义 ASP.NET 服务要使用的复杂数据类型需要使用 .NET Framework 类的定义,这些类可由 xref:System.Xml.Serialization.XmlSerializer 序列化为 XML 或从 XML 进行反序列化。 这些类可以手动编写,或者使用命令行 XML 架构/数据类型支持实用工具 xsd.exe 从 XML 架构中的类型定义生成。

下面是定义可由 xref:System.Xml.Serialization.XmlSerializer 序列化为 XML 或从 XML 序列化的 .NET Framework 类时需要了解的关键问题列表:

WCF 应用程序开发通常也开始的复杂类型的定义。 WCF 可为使用相同的.NET Framework 类作为 ASP.NET Web 服务。

WCFxref:System.Runtime.Serialization.DataContractAttribute和xref:System.Runtime.Serialization.DataMemberAttribute将添加到.NET Framework 类型,以指示该类型的实例将要序列化为 XML,以及哪些特定字段或属性的类型进行序列化,如下面的示例代码中所示。

//Example One:
[DataContract]
public class LineItem
{
    [DataMember]
    public string ItemNumber;
    [DataMember]
    public decimal Quantity;
    [DataMember]
    public decimal UnitPrice;
}

//Example Two:
public class LineItem
{
    [DataMember]
    private string itemNumber;
    [DataMember]
    private decimal quantity;
    [DataMember]
    private decimal unitPrice;

    public string ItemNumber
    {
      get
      {
          return this.itemNumber;
      }

      set
      {
          this.itemNumber = value;
      }
    }

    public decimal Quantity
    {
        get
        {
            return this.quantity;
        }

        set
        {
            this.quantity = value;
        }
    }

    public decimal UnitPrice
    {
      get
      {
          return this.unitPrice;
      }

      set
      {
          this.unitPrice = value;
      }
    }
}

//Example Three:
public class LineItem
{
     private string itemNumber;
     private decimal quantity;
     private decimal unitPrice;

     [DataMember]
     public string ItemNumber
     {
       get
       {
          return this.itemNumber;
       }

       set
       {
           this.itemNumber = value;
       }
     }

     [DataMember]
     public decimal Quantity
     {
          get
          {
              return this.quantity;
          }

          set
          {
             this.quantity = value;
          }
     }

     [DataMember]
     public decimal UnitPrice
     {
          get
          {
              return this.unitPrice;
          }

          set
          {
              this.unitPrice = value;
          }
     }
}

xref:System.Runtime.Serialization.DataContractAttribute 表示要对零个或多个类型字段或属性进行序列化,而 xref:System.Runtime.Serialization.DataMemberAttribute 表示要对某个特定字段或属性进行序列化。 xref:System.Runtime.Serialization.DataContractAttribute 可应用于类或结构。 xref:System.Runtime.Serialization.DataMemberAttribute 可以应用于字段或属性 (Property),对其应用此属性 (Attribute) 的字段和属性 (Property) 既可以是公共的也可以是私有的。 具有的类型的实例xref:System.Runtime.Serialization.DataContractAttribute应用于它们所提及的 WCF 中的数据协定。 它们通过 xref:System.Runtime.Serialization.DataContractSerializer 序列化为 XML。

下面是使用 xref:System.Runtime.Serialization.DataContractSerializer 和使用 xref:System.Xml.Serialization.XmlSerializer 以及 xref:System.Xml.Serialization 命名空间的各种属性之间的重大差异列表。

不管存在何种差异,只要 XML 具有显式定义的命名空间,默认情况下,xref:System.Xml.Serialization.XmlSerializer 将类型序列化为的 XML 与 xref:System.Runtime.Serialization.DataContractSerializer 将类型序列化为的 XML 语义相同。 下面的类具有用于这两种序列化程序的属性,将转换为的语义相同的 XMLxref:System.Xml.Serialization.XmlSerializer和xref:System.Runtime.Serialization.DataContractAttribute:

[Serializable]
[XmlRoot(Namespace="urn:Contoso:2006:January:29")]
[DataContract(Namespace="urn:Contoso:2006:January:29")]
public class LineItem
{
     [DataMember]
     public string ItemNumber;
     [DataMember]
     public decimal Quantity;
     [DataMember]
     public decimal UnitPrice;
}

Windows 软件开发工具包 (SDK) 包含名为的命令行工具ServiceModel Metadata Utility Tool (Svcutil.exe)。 喜欢使用与 ASP.NET Web 服务的 xsd.exe 工具 Svcutil.exe 可以从 XML 架构生成的.NET 数据类型定义。 如果 xref:System.Runtime.Serialization.DataContractSerializer 可发出由 XML 架构定义的格式的 XML,类型将为数据协定;否则,它们专用于通过 xref:System.Xml.Serialization.XmlSerializer 进行序列化。 Svcutil.exe 还可以生成 XML 架构从数据协定使用其dataContractOnly切换。

Note: 尽管 ASP.NET Web 服务使用xref:System.Xml.Serialization.XmlSerializer,并且 WCF ASP.NET 兼容模式会使 WCF 服务模拟 ASP.NET Web 服务的行为,ASP.NET 兼容性选项不会限制用户使用xref:System.Xml.Serialization.XmlSerializer。 用户仍然可以将 xref:System.Runtime.Serialization.DataContractSerializer 用于以 ASP.NET 兼容模式运行的服务。

服务开发

要使用 ASP.NET 开发服务,通常会将 xref:System.Web.Services.WebService 属性添加到类中,并将 xref:System.Web.Services.WebMethodAttribute 添加到该类中将作为服务操作使用的任意方法上:

[WebService]
public class Service : T:System.Web.Services.WebService
{
    [WebMethod]
    public string Echo(string input)
    {
       return input;
    }
}

ASP.NET 2.0 中引入了将属性 xref:System.Web.Services.WebService 和 xref:System.Web.Services.WebMethodAttribute 添加到接口(而不是类)的选项,并编写了一个类实现此接口:

[WebService]
public interface IEcho
{
    [WebMethod]
    string Echo(string input);
}

public class Service : IEcho
{

   public string Echo(string input)
   {
        return input;
    }
}

使用此选项是首选方法,因为具有 xref:System.Web.Services.WebService 属性的接口包含服务所执行操作的协定,该服务可以在通过多种不同方式实现同一协定的各种类中重复使用。

通过定义一个或多个 WCF 终结点提供一个 WCF 服务。 终结点由地址、绑定和服务协定定义。 地址用于定义服务的位置。 绑定用于指定与服务的通信方式。 服务协定用于定义服务可执行的操作。

通常最先定义服务协定,通过将 xref:System.ServiceModel.ServiceContractAttribute 和 xref:System.ServiceModel.OperationContractAttribute 添加到接口中实现:

[ServiceContract]
public interface IEcho
{
     [OperationContract]
     string Echo(string input);
}

xref:System.ServiceModel.ServiceContractAttribute指定该接口定义 WCF 服务约定,和xref:System.ServiceModel.OperationContractAttribute指示,如果有,接口的方法的定义服务协定的操作。

定义服务协定后,它将在类中实现,方法是使类实现服务协定定义的接口:

public class Service : IEcho
{
    public string Echo(string input)
    {
       return input;
    }
}

实现服务协定的类称为作为一种服务类型在 WCF 中。

下一步是将地址和绑定与服务类型关联。 通常是在配置文件中,通过编辑文件直接或通过使用与 WCF 提供的配置编辑器。 下面是配置文件的示例。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
     <system.serviceModel>
      <services>
      <service name="Service ">
       <endpoint
        address="EchoService"
        binding="basicHttpBinding"
        contract="IEchoService "/>
      </service>
      </services>
     </system.serviceModel>
</configuration>

绑定指定用于与应用程序通信的协议集。 下表列出由系统提供的表示常用选项的绑定。

名称 用途
BasicHttpBinding 可以与支持 WS-BasicProfile 1.1 和 Basic Security Profile 1.0 的 Web 服务和客户端相互操作。
WSHttpBinding 可以与通过 HTTP 支持 WS* 协议的 Web 服务和客户端相互操作。
WSDualHttpBinding 双向 HTTP 通信,使用此绑定时初始消息的接收方不直接回复初始发送方,而是在一段时间内使用与 WS* 协议一致的 HTTP 传输任意数量的响应。
WSFederationBinding 访问服务资源时所用的 HTTP 通信可根据由显式标识的凭据提供程序发出的凭据进行控制。
NetTcpBinding 在网络上的 WCF 软件实体之间的安全、 可靠、 高性能通信。
NetNamedPipeBinding 同一台计算机上的 WCF 软件实体之间的安全、 可靠、 高性能通信。
NetMsmqBinding 通过使用 MSMQ 的 WCF 软件实体之间的通信。
MsmqIntegrationBinding WCF 软件实体和通过使用 MSMQ 的另一个软件实体之间的通信。
NetPeerTcpBinding 通过使用 Windows 对等网络 WCF 软件实体之间的通信。

系统提供的绑定 xref:System.ServiceModel.BasicHttpBinding 集成了 ASP.NET Web 服务支持的协议集。

自定义绑定的 WCF 应用程序轻松地定义为 WCF 使用来实现单个协议的绑定元素类的集合。 可以将新的绑定元素编写为表示其他协议。

服务类型的内部行为可以使用一系列称为行为的类的属性对其进行调整。 其中,xref:System.ServiceModel.ServiceBehaviorAttribute 类用于指定服务类型为多线程。

[ServiceBehavior(ConcurrencyMode=ConcurrencyMode.Multiple]
public class DerivativesCalculatorServiceType: IDerivativesCalculator

某些行为是属性,如 xref:System.ServiceModel.ServiceBehaviorAttribute。 其他具有管理员希望设置的属性的行为可以在配置应用程序时修改。

在编程服务类型中,通常使用 xref:System.ServiceModel.OperationContext 类。 它的静态 xref:System.ServiceModel.OperationContext.Current* 属性提供对有关运行操作上下文的信息的访问权限。 xref:System.ServiceModel.OperationContext 类似于 xref:System.Web.HttpContext 和 xref:System.EnterpriseServices.ContextUtil 类。

宿主

ASP.NET Web 服务编译为类库程序集。 将提供一个称为服务文件且扩展名为 .asmx 的文件,该文件包含一条 @ WebService 指令,该指令标识的类包含表示服务和服务所在程序集的代码。

<%@ WebService Language="C#" Class="Service,ServiceAssembly" %>

在 Internet 信息服务 (IIS) 中,服务文件将复制到 ASP.NET 应用程序根目录下,程序集则复制到此应用程序根目录的 \bin 子目录下。 然后,您可以在应用程序根目录下使用服务文件的统一资源定位符 (URL) 访问此应用程序。

在 IIS 5.1 或 6.0 中,Windows 进程激活服务 (WAS) 作为 IIS 7.0 的一部分提供的和任何.NET 应用程序内,可以轻松承载 WCF 服务。 若要在 IIS 5.1 或 6.0 中承载某项服务,此服务必须使用 HTTP 作为通信传输协议。

若要在 IIS 5.1、6.0 或 WAS 中承载某项服务,请使用下列步骤:

  1. 将此服务类型编译为类库程序集。

  2. 使用标识服务类型的 @ ServiceHost 指令创建一个扩展名为 .svc 的服务文件:

    <%@ServiceHost language="c#" Service="MyService" %>
    
  3. 将服务文件复制到虚拟目录下,并将程序集复制到该虚拟目录的 \bin 子目录下。

  4. 将配置文件复制到虚拟目录下,并将其命名为 Web.config。

然后,您可以在应用程序根目录下使用服务文件的 URL 访问此应用程序

若要托管.NET 应用程序中的 WCF 服务,编译类库程序集引用的应用程序,此服务类型和服务使用向主机应用程序进行编程xref:System.ServiceModel.ServiceHost类。 下面是所需基本编程的示例:

string httpBaseAddress = "http://www.contoso.com:8000/";
string tcpBaseAddress = "net.tcp://www.contoso.com:8080/";

Uri httpBaseAddressUri = new Uri(httpBaseAddress);
Uri tcpBaseAddressUri = new Uri(tcpBaseAddress);

Uri[] baseAddresses = new Uri[] {
 httpBaseAddressUri,
 tcpBaseAddressUri};

using(ServiceHost host = new ServiceHost(
typeof(Service), //"Service" is the name of the service type baseAddresses))
{
     host.Open();

     […] //Wait to receive messages
     host.Close();
}

此示例演示如何在构造 xref:System.ServiceModel.ServiceHost 时指定一个或多个传输协议的地址。 这些地址称为基址。

提供的 WCF 服务的任何终结点的地址是主机的相对于终结点的基址的地址。 对于每个通信传输协议,宿主都可以有一个基址。 在上面的配置文件配置示例中,为终结点选定的 xref:System.ServiceModel.BasicHttpBinding 将 HTTP 用作传输协议,因此终结点的地址 EchoService 与宿主的 HTTP 基址相关。 在前面的示例中的主机,对于 HTTP 基址是http://www.contoso.com:8000/。 对于在 IIS 或 WAS 中承载的服务,其基址为服务的服务文件的 URL。

仅服务承载于 IIS 或 WAS,并且其配置为包含 HTTP 作为传输协议以独占方式,可使用 WCF ASP.NET 兼容模式选项。 启用此选项需要执行下列步骤。

  1. 程序员必须将 xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute 属性添加到服务类型中,并指定是允许还是需要 ASP.NET 兼容模式。

    [System.ServiceModel.Activation.AspNetCompatibilityRequirements(
          RequirementsMode=AspNetCompatibilityRequirementsMode.Require)]
    public class DerivativesCalculatorServiceType: IDerivativesCalculator
    
  2. 管理员必须将应用程序配置为使用 ASP.NET 兼容模式。

    <configuration>
         <system.serviceModel>
          <services>
          […]
          </services>
          <serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>
        </system.serviceModel>
    </configuration>
    

    WCF 应用程序还可以配置为使用.asmx 作为扩展他们的服务文件而不是.svc。

    <system.web>
         <compilation>
          <compilation debug="true">
          <buildProviders>
           <remove extension=".asmx"/>
           <add extension=".asmx"
            type="System.ServiceModel.ServiceBuildProvider,
            System.ServiceModel,
            Version=3.0.0.0,
            Culture=neutral,
            PublicKeyToken=b77a5c561934e089" />
          </buildProviders>
          </compilation>
         </compilation>
    </system.web>
    

    该选项可以将保存您无需修改配置为使用.asmx 服务文件的 Url 时修改服务使用 WCF 客户端。

客户端开发

ASP.NET Web 服务的客户端通过使用命令行工具 WSDL.exe 生成,该工具可将 .asmx 文件的 URL 作为输入提供。 WCF 提供的相应工具是ServiceModel Metadata Utility Tool (Svcutil.exe)。 它将生成服务协定的定义和 WCF 客户端类的定义的代码模块。 它还使用服务的地址和绑定生成一个配置文件。

通常,建议您基于异步模式对远程服务的客户端进行编程。 默认情况下,不论是同步模式还是异步模式,始终都会提供由 WSDL.exe 工具生成的代码。 生成的代码ServiceModel Metadata Utility Tool (Svcutil.exe)可以为任意一种模式提供。 默认为对同步模式提供。 如果执行该工具时使用 /async 开关,则将为异步模式提供生成的代码。

则生成的 ASP 的 WCF 客户端类中的名称不能保证。NET 的 WSDL.exe 工具,默认情况下,匹配由 Svcutil.exe 工具生成的 WCF 客户端类中的名称。 尤其是,在默认情况下,必须使用 xref:System.Xml.Serialization.XmlSerializer 序列化的类的属性名将在 Svcutil.exe 工具生成的代码中获得后缀 Property,这与 WSDL.exe 工具的情况并不一样。

消息表示形式

可以对由 ASP.NET Web 服务发送和接收的 SOAP 消息头执行自定义操作。 将从 xref:System.Web.Services.Protocols.SoapHeader 派生一个类,用于定义消息头的结构,然后 xref:System.Web.Services.Protocols.SoapHeaderAttribute 用于指示存在消息头。

public class SomeProtocol : SoapHeader
{
     public long CurrentValue;
     public long Total;
}

[WebService]
public interface IEcho
{
     SomeProtocol ProtocolHeader
     {
      get;
     set;
     }

     [WebMethod]
     [SoapHeader("ProtocolHeader")]
     string PlaceOrders(PurchaseOrderType order);
}

public class Service: WebService, IEcho
{
     private SomeProtocol protocolHeader;

     public SomeProtocol ProtocolHeader
     {
         get
         {
              return this.protocolHeader;
         }

         set
         {
              this.protocolHeader = value;
         }
     }

     string PlaceOrders(PurchaseOrderType order)
     {
         long currentValue = this.protocolHeader.CurrentValue;
     }
}

WCF 提供的特性, xref:System.ServiceModel.MessageContractAttribute, xref:System.ServiceModel.MessageHeaderAttribute,和xref:System.ServiceModel.MessageBodyMemberAttribute描述由服务发送和接收的 SOAP 消息的结构。

[DataContract]
public class SomeProtocol
{
     [DataMember]
     public long CurrentValue;
     [DataMember]
     public long Total;
}

[DataContract]
public class Item
{
     [DataMember]
     public string ItemNumber;
     [DataMember]
     public decimal Quantity;
     [DataMember]
     public decimal UnitPrice;
}

[MessageContract]
public class ItemMessage
{
     [MessageHeader]
     public SomeProtocol ProtocolHeader;
     [MessageBody]
     public Item Content;
}

[ServiceContract]
public interface IItemService
{
     [OperationContract]
     public void DeliverItem(ItemMessage itemMessage);
}

此语法将生成消息结构的显式表示形式,同时 ASP.NET Web 服务的代码也将暗示消息结构。 此外,在 ASP.NET 语法中,消息头表示为属性的服务,如ProtocolHeader属性在上一示例中,而在 WCF 语法,它们可以更准确地表示为消息的属性。 此外,WCF 允许将消息标头添加到终结点的配置。

<service name="Service ">
     <endpoint
      address="EchoService"
      binding="basicHttpBinding"
      contract="IEchoService ">
      <headers>
      <dsig:X509Certificate
       xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">
       ...
      </dsig:X509Certificate>
      </headers>
     </endpoint>
</service>

使用此选项,可以在客户端或服务的代码中避免任何对基础协议标头的引用:标头将根据终结点的配置方式添加到消息中。

服务说明

使用查询 WSDL 对 ASP.NET Web 服务的 .asmx 文件发出 HTTP GET 请求将使 ASP.NET 生成描述服务的 WSDL。 ASP.NET 将返回该 WSDL 作为此请求的响应。

通过 ASP.NET 2.0,用户可以验证服务是否与 Web 服务互操作性组织 (WS-I) 的基本配置文件 1.1 兼容,还可以插入一个声明表明服务与其 WSDL 兼容。 这可以通过使用 ConformsTo 属性的 EmitConformanceClaims 和 xref:System.Web.Services.WebServiceBindingAttribute 参数实现。

[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(
     ConformsTo = WsiProfiles.BasicProfile1_1,
     EmitConformanceClaims=true)]
public interface IEcho

可以自定义 ASP.NET 为服务生成的 WSDL。 通过创建 xref:System.Web.Services.Description.ServiceDescriptionFormatExtension 的派生类以将项目添加到 WSDL 中可实现自定义。

使用 HTTP 终结点承载在 IIS 51 使用查询 WSDL 的 WCF 服务的.svc 文件发出 HTTP GET 请求,6.0 或 WAS 会导致 WCF 具有描述服务的 WSDL 响应。 如果 httpGetEnabled 设置为 true,则使用查询 WSDL 对 .NET 应用程序所承载服务的 HTTP 基址发出 HTTP GET 请求具有相同的效果。

但是,WCF 还响应 Ws-metadataexchange 请求具有其生成的用于描述服务的 WSDL。 ASP.NET Web 服务没有对 WS-MetadataExchange 请求的内置支持。

可以广泛地自定义 WCF 生成的 WSDL。 xref:System.ServiceModel.Description.ServiceMetadataBehavior 类提供了一些用于自定义 WSDL 的功能。 WCF 还可以配置为不生成 WSDL,但而不是在给定的 URL,使用静态 WSDL 文件。

<behaviors>
     <behavior name="DescriptionBehavior">
     <metadataPublishing
      enableMetadataExchange="true"
      enableGetWsdl="true"
      enableHelpPage="true"
      metadataLocation=
      "http://localhost/DerivativesCalculatorService/Service.WSDL"/>
     </behavior>
</behaviors>

异常处理

在 ASP.NET Web 服务中,未处理的异常将作为 SOAP 错误返回客户端。 您还可以显式抛出 xref:System.Web.Services.Protocols.SoapException 类的实例并对传输到客户端的 SOAP 错误内容加大控制力度。

WCF 服务中未经处理的异常不会返回到客户端作为 SOAP 错误以防止敏感信息通过异常意外公开。 为了进行调试,系统将提供一个配置设置以将未处理的异常返回客户端。

若要将 SOAP 错误返回客户端,您可以使用数据协定类型作为泛型类型抛出泛型类型的实例 xref:System.ServiceModel.FaultException`1。 您还可以将 xref:System.ServiceModel.FaultContractAttribute 属性添加到操作中以指定操作可能会生成的错误。

[DataContract]
public class MathFault
{
     [DataMember]
     public string operation;
     [DataMember]
     public string problemType;
}

[ServiceContract]
public interface ICalculator
{
     [OperationContract]
     [FaultContract(typeof(MathFault))]
     int Divide(int n1, int n2);
}

这样做会导致在服务的 WSDL 中显示对可能错误的建议,从而使客户端程序员可以预计操作可能会导致哪些错误,并编写相应的 Catch 语句。

try
{
     result = client.Divide(value1, value2);
}
catch (FaultException<MathFault> e)
{
 Console.WriteLine("FaultException<MathFault>: Math fault while doing "
  + e.Detail.operation
  + ". Problem: "
  + e.Detail.problemType);
}

状态管理

用于实现 ASP.NET Web 服务的类可以从 xref:System.Web.Services.WebService 派生。

public class Service : WebService, IEcho
{

 public string Echo(string input)
 {
  return input;
 }
}

在此情况下,可以将此类编程为使用 xref:System.Web.Services.WebService 基类的“上下文”属性访问 xref:System.Web.HttpContext 对象。 通过使用 xref:System.Web.HttpContext 对象的 Application 属性,该对象可用于更新和检索应用程序状态信息,而且通过使用其 Session 属性,该对象可用于更新和检索会话状态信息。

ASP.NET 通过使用实际存储着 xref:System.Web.HttpContext 的 Session 属性对会话状态信息的访问位置提供高度控制。 它可以存储在 Cookie、数据库、当前服务器的内存或指定服务器的内存中。 在服务的配置文件中做出此项选择。

WCF 为状态管理提供可扩展对象。 可扩展对象就是实现 xref:System.ServiceModel.IExtensibleObject`1 的对象。 最重要的可扩展对象为 xref:System.ServiceModel.ServiceHostBase 和 xref:System.ServiceModel.InstanceContext。 ServiceHostBase 允许您保持同一个宿主上所有服务类型的所有实例都可访问的状态,而 InstanceContext 允许您保持可以被某个服务类型的同一个实例中运行的任意代码访问的状态。

此处,服务类型, TradingSystem,具有xref:System.ServiceModel.ServiceBehaviorAttribute,它指定从同一个 WCF 客户端实例的所有呼叫都会都路由到同一服务类型的实例。

[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class TradingSystem: ITradingService

DealData 类用于定义可以由某个服务类型的相同实例中运行的任意代码访问的状态。

internal class DealData: IExtension<InstanceContext>
{
 public string DealIdentifier = null;
 public Trade[] Trades = null;
}

在实现服务协定中任一操作的服务类型的代码中,将 DealData 状态对象添加到当前服务类型实例的状态中。

string ITradingService.BeginDeal()
{
 string dealIdentifier = Guid.NewGuid().ToString();
 DealData state = new DealData(dealIdentifier);
 OperationContext.Current.InstanceContext.Extensions.Add(state);
 return dealIdentifier;
}

随后,可以使用实现另一个服务协定操作的代码检索和修改此状态对象。

void ITradingService.AddTrade(Trade trade)
{
 DealData dealData =  OperationContext.Current.InstanceContext.Extensions.Find<DealData>();
 dealData.AddTrade(trade);
}

而 ASP.NET 通过提供控件状态信息的位置中xref:System.Web.HttpContext实际存储类,WCF,至少在其初始版本中,提供了无法控制的可扩展对象的存储位置。 构成选择的 WCF 服务的 ASP.NET 兼容性模式的最佳原因的。 如果必须管理可配置状态,则选择 ASP.NET 兼容模式使您可以按照它们在 ASP.NET 中的使用方式使用 xref:System.Web.HttpContext 类的功能,而且还可以通过使用存储的 xref:System.Web.HttpContext 类配置状态信息的管理位置。

安全性

用于保证 ASP.NET Web 服务安全的选项就是那些用于保证任意 IIS 应用程序安全的选项。 由于可以托管 WCF 应用程序,不仅在 IIS 中,还在任何.NET 可执行文件,因此必须进行选项用于保护 WCF 应用程序独立于 IIS 的功能。 但是,为 ASP.NET Web 服务提供的功能也已可供在 ASP.NET 兼容模式下运行的 WCF 服务。

安全性:身份验证

IIS 提供的功能来控制访问应用程序可以依据选择匿名访问或各种身份验证模式:Windows 身份验证、 摘要式身份验证、 基本身份验证和.NET Passport 身份验证。 Windows 身份验证选项可以用于控制对 ASP.NET Web 服务的访问。 但是,当在 IIS 中托管 WCF 应用程序,必须配置 IIS 以允许匿名访问应用程序,以便可以按 WCF 本身,支持 Windows 身份验证以及各种其他选项管理身份验证。 其他内置选项包括用户名令牌、X.509 证书、SAML 令牌和 CardSpace 卡,但是也可以定义自定义身份验证机制。

安全性:Impersonation

ASP.NET 提供一个标识元素,ASP.NET Web 服务可通过使用该元素模拟当前请求提供了某个特定用户或任何用户的凭据。 该元素可以用于在 ASP.NET 兼容模式下运行的 WCF 应用程序中对模拟进行配置。

WCF 配置系统提供用于指定要模拟特定的用户将自己标识的元素。 此外,WCF 客户端和服务可以独立配置进行模拟。 当客户端发送请求时,可将它们配置为模拟当前用户。

<behaviors>
     <behavior name="DerivativesCalculatorClientBehavior">
      <clientCredentials>
      <windows allowedImpersonationLevel="Impersonation"/>
      </clientCredentials>
     </behavior>
</behaviors>

可将服务操作配置为模拟当前请求提供了任意用户的凭据。

[OperationBehavior(Impersonation = ImpersonationOption.Required)]
public void Receive(Message input)

安全性:使用访问控制列表进行授权

访问控制列表 (ACL) 可用于限制对 .asmx 文件的访问。 但是,WCF.svc 文件的 Acl 将除忽略在 ASP.NET 兼容模式下。

安全性:基于角色的授权

IIS Windows 身份验证选项可与由 ASP.NET 配置语言提供的授权元素一起使用,以便根据将用户指定到的 Windows 组简化对 ASP.NET Web 服务的基于角色的授权。 ASP.NET 2.0 引入了一种更常用的基于角色的授权机制:角色提供程序。

角色提供程序就是所有实现基本接口以查询对用户分配哪些角色的类,但每个角色提供程序都知道如何从其他来源检索此信息。 ASP.NET 2.0 提供一个可从 Microsoft SQL Server 数据库检索角色分配的角色提供程序,同时还提供另一个可从 Windows Server 2003 授权管理器检索角色分配的角色提供程序。

角色提供程序机制实际上可以独立于 ASP.NET 在任何.NET 应用程序,包括 WCF 应用程序中使用。 下面的示例配置为 WCF 应用程序演示了如何使用 ASP.NET 角色提供程序是通过所选的选项xref:System.ServiceModel.Description.ServiceAuthorizationBehavior。

<system.serviceModel>
     <services>
         <service name="Service.ResourceAccessServiceType"
             behaviorConfiguration="ServiceBehavior">
             <endpoint
              address="ResourceAccessService"
              binding="wsHttpBinding"
              contract="Service.IResourceAccessContract"/>
         </service>
     </services>
     <behaviors>
       <behavior name="ServiceBehavior">
       <serviceAuthorization principalPermissionMode="UseAspNetRoles"/>
      </behavior>
     </behaviors>
</system.serviceModel>

安全性:基于声明的授权

WCF 的最重要的创新之一是它授予对基于声明的受保护资源的访问权限的全面支持。 声明包含类型、权限和值等,例如驾驶执照。 它提出一组有关持有人的声明,其中一个是持有人的出生日期。 此声明的类型为出生日期,而声明的值为司机的出生日期。 声明授予持有人的权限指定持有人可对声明的值执行的操作。 如果是要声明司机的出生日期,权限为拥有:司机拥有该出生日期但是不能更改它。 基于声明的授权包含基于角色的授权,因为角色也是一种声明类型。

基于声明的授权可通过将一组声明与操作的访问要求进行比较实现,根据比较的结果,可获得操作的访问权或遭到拒绝。 在 WCF 中,可以指定要用于通过将分配到的值再一次运行基于声明的授权的类ServiceAuthorizationManager属性的xref:System.ServiceModel.Description.ServiceAuthorizationBehavior。

<behaviors>
     <behavior name='ServiceBehavior'>
     <serviceAuthorization
     serviceAuthorizationManagerType=
                   'Service.AccessChecker, Service' />
     </behavior>
</behaviors>

用于运行基于声明的授权的类必须派生自只有一种重写方法(即 xref:System.ServiceModel.ServiceAuthorizationManager)的 AccessCheck()。 WCF 将调用该方法时的服务操作调用,并提供xref:System.ServiceModel.OperationContext具有该用户的声明的对象中其ServiceSecurityContext.AuthorizationContext属性。 WCF 执行工作组装来自任何安全令牌的有关用户的声明的用户进行身份验证,这会使提供评估这些声明是否满足需要相关操作任务。

WCF 自动汇集从任何类型声明标记是安全的非常重要的创新,因为它使基于声明的身份验证机制完全独立的授权代码。 与此相反,使用 ACL 或 ASP.NET 中的角色进行授权则与 Windows 身份验证息息相关。

安全性:保密性

通过将 IIS 中的应用程序配置为使用安全超文本传输协议 (HTTPS),可以在传输级别确保与 ASP.NET Web 服务交换的消息的机密性。 对于在 IIS 内承载的 WCF 应用程序可以实现相同目的。 但是,WCF 应用程序承载于 IIS 之外,还可以配置为使用安全传输协议。 更重要的是,WCF 应用程序还可以配置为之前它们传输,使用 Ws-security 协议保护消息的安全。 如果使用 WS-Security 协议保护消息正文的安全,则消息正文到达最终目的地之前在中介中加密传输。

全球化

通过 ASP.NET 配置语言,您可以为这些服务单独指定区域性。 在 ASP.NET 兼容模式下,WCF 不支持除该配置设置。 若要本地化不使用 ASP.NET 兼容模式的 WCF 服务,编译为特定于区域性的程序集的服务类型和每个特定于区域性的程序集具有单独的特定于区域性的终结点。

请参阅

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

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

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