AspNetCompatibilityRequirementsAttribute Classe

Definição

public ref class AspNetCompatibilityRequirementsAttribute sealed : Attribute, System::ServiceModel::Description::IServiceBehavior

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class AspNetCompatibilityRequirementsAttribute : Attribute, System.ServiceModel.Description.IServiceBehavior

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type AspNetCompatibilityRequirementsAttribute = class
    inherit Attribute
    interface IServiceBehavior

Public NotInheritable Class AspNetCompatibilityRequirementsAttribute
Inherits Attribute
Implements IServiceBehavior

Herança

Object

Attribute

AspNetCompatibilityRequirementsAttribute

Atributos

AttributeUsageAttribute

Implementações

IServiceBehavior

Exemplos

Os programadores de serviços podem garantir que o seu serviço só é executado em Modo de Compatibilidade ASP.NET definindo a propriedade RequirementsMode no AspNetCompatibilityRequirementsAttribute para Required, como mostrado no exemplo seguinte

[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 Equals();
}

<ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples")> _
Public Interface ICalculatorSession

    <OperationContract()> _
    Sub Clear()
    <OperationContract()> _
    Sub AddTo(ByVal n As Double)
    <OperationContract()> _
    Sub SubtractFrom(ByVal n As Double)
    <OperationContract()> _
    Sub MultiplyBy(ByVal n As Double)
    <OperationContract()> _
    Sub DivideBy(ByVal n As Double)
    <OperationContract()> _
    Function Equal() As Double
End Interface

[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()
    {
    }

    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 Equals()
    {
        return result;
    }
}

    <AspNetCompatibilityRequirements(RequirementsMode:=AspNetCompatibilityRequirementsMode.Required)> _
    Public Class CalculatorService
        Implements ICalculatorSession

        Property Result() As Double
            ' Store result in AspNet Session.
            Get
                If (HttpContext.Current.Session("Result") Is Nothing) Then
                    Return 0D
                End If
                Return HttpContext.Current.Session("Result")
            End Get
            Set(ByVal value As Double)
                HttpContext.Current.Session("Result") = value
            End Set
        End Property

        Public Sub Clear() _
 Implements ICalculatorSession.Clear
            Result = 0D
        End Sub

        Public Sub AddTo(ByVal n As Double) _
Implements ICalculatorSession.AddTo
            Result += n
        End Sub

        Public Sub SubtractFrom(ByVal n As Double) _
Implements ICalculatorSession.SubtractFrom

            Result -= n
        End Sub

        Public Sub MultiplyBy(ByVal n As Double) _
Implements ICalculatorSession.MultiplyBy

            Result *= n
        End Sub

        Public Sub DivideBy(ByVal n As Double) _
Implements ICalculatorSession.DivideBy

            Result /= n
        End Sub

        Public Function Equal() As Double _
Implements ICalculatorSession.Equal

            Return Result
        End Function
    End Class

Observações

Quando aplicado a uma classe de implementação de serviço, este atributo indica se este serviço requer ou suporta o modo de compatibilidade ASP.NET para estar ativado para o domínio de aplicação anfitrião (AppDomain).

AppDomains que alojam serviços WCF podem funcionar em dois modos de alojamento diferentes:

• Modo de Transporte Misto (Padrão): Neste modo, os serviços WCF não participam no pipeline HTTP ASP.NET. Isto garante que um serviço WCF se comporta de forma consistente, independentemente do ambiente de alojamento e do transporte.

• Modo de Compatibilidade ASP.NET: Neste modo, os serviços WCF participam no pipeline HTTP ASP.NET de forma semelhante aos serviços ASMX. Funcionalidades do ASP.NET como Autorização de Ficheiros, Authorização Url e Estado de Sessão HTTP são aplicáveis a serviços WCF a correr neste modo.

O modo de alojamento é controlado pela flag aspNetCompatibilityEnabledde configuração ao nível da aplicação .

<system.serviceModel>

<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>

</system.serviceModel>

Esta flag é false por defeito e, por isso, os serviços WCF correm no Modo de Transportes Mistos, a menos que opte explicitamente pelo modo de compatibilidade ASP.NET.

Para mais informações sobre o modo de compatibilidade ASP.NET, consulte <serviceHostingEnvironment>.

Use a RequirementsMode propriedade para isso. Em tempo de execução, as aplicações podem detetar se ASP.NET modo de compatibilidade está ativado verificando o valor da propriedade estática AspNetCompatibilityEnabled.