AspNetCompatibilityRequirementsAttribute Klass

Definition

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

Arv

Object

Attribute

AspNetCompatibilityRequirementsAttribute

Attribut

AttributeUsageAttribute

Implementeringar

IServiceBehavior

Exempel

Tjänstutvecklare kan se till att tjänsten endast körs i ASP.NET kompatibilitetsläge genom att ange egenskapen RequirementsMode på egenskapen AspNetCompatibilityRequirementsAttribute till Required enligt följande exempel

[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

Kommentarer

När det tillämpas på en tjänstimplementeringsklass anger det här attributet om den här tjänsten kräver eller stöder ASP.NET kompatibilitetsläge som ska aktiveras för värdprogramdomänen (AppDomain).

AppDomains som är värd för WCF-tjänster kan köras i två olika värdlägen:

• Blandat transportläge (standard): I det här läget deltar inte WCF-tjänster i ASP.NET HTTP-pipeline. Detta garanterar att en WCF-tjänst fungerar konsekvent, oberoende av värdmiljö och transport.

• ASP.NET Kompatibilitetsläge: I det här läget deltar WCF-tjänster i ASP.NET HTTP-pipeline på ett sätt som liknar ASMX-tjänster. ASP.NET funktioner som Filauktorisering, UrlAuthorization och HTTP-sessionstillstånd gäller för WCF-tjänster som körs i det här läget.

Värdläget styrs av konfigurationsflaggan aspNetCompatibilityEnabledpå programnivå .

<system.serviceModel>

<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>

</system.serviceModel>

Den här flaggan är false som standard och därför körs WCF-tjänster i läget Blandade transporter såvida du inte uttryckligen väljer ASP.NET kompatibilitetsläge.

Mer information om ASP.NET kompatibilitetsläge finns i <serviceHostingEnvironment>.

Använd egenskapen RequirementsMode för att göra detta. Vid körning kan program identifiera om ASP.NET kompatibilitetsläge är aktiverat genom att kontrollera värdet för den statiska egenskapen AspNetCompatibilityEnabled.