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 desenvolvedores de serviços podem garantir que seu serviço seja executado apenas no modo de compatibilidade ASP.NET definindo a RequirementsMode propriedade como AspNetCompatibilityRequirementsAttribute Required mostrada no exemplo a seguir

[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

Comentários

Quando aplicado a uma classe de implementação de serviço, esse atributo indica se esse serviço requer ou dá suporte ASP.NET modo de compatibilidade a ser habilitado para o domínio do aplicativo de hospedagem (AppDomain).

Os serviços WCF de hospedagem do AppDomains podem ser executados em dois modos de hospedagem diferentes:

• Modo de Transportes Mistos (Padrão): nesse modo, os serviços do WCF não participam do pipeline HTTP ASP.NET. Isso garante que um serviço WCF se comporte consistentemente, independentemente do ambiente de hospedagem e do transporte.

• ASP.NET Modo de Compatibilidade: nesse modo, os serviços do WCF participam do pipeline HTTP ASP.NET de maneira semelhante aos serviços ASMX. ASP.NET recursos como Autorização de Arquivo, UrlAuthorization e Estado da Sessão HTTP são aplicáveis aos serviços do WCF em execução nesse modo.

O modo de hospedagem é controlado pelo sinalizador aspNetCompatibilityEnabledde configuração no nível do aplicativo.

<system.serviceModel>

<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>

</system.serviceModel>

Esse sinalizador é false por padrão e, portanto, os serviços WCF são executados no Modo de Transportes Mistos, a menos que você opte explicitamente pelo modo de compatibilidade ASP.NET.

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

Use a RequirementsMode propriedade para fazer isso. Em runtime, os aplicativos podem detectar se ASP.NET modo de compatibilidade está habilitado verificando o valor da propriedade AspNetCompatibilityEnabledestática.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a