AspNetCompatibilityRequirementsAttribute Klas

Definitie

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

Overname

Object

Attribute

AspNetCompatibilityRequirementsAttribute

Kenmerken

AttributeUsageAttribute

Implementeringen

IServiceBehavior

Voorbeelden

Serviceontwikkelaars kunnen ervoor zorgen dat hun service alleen wordt uitgevoerd in ASP.NET compatibiliteitsmodus door de eigenschap RequirementsMode op de AspNetCompatibilityRequirementsAttribute in te stellen op Required, zoals wordt weergegeven in het volgende voorbeeld

[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

Opmerkingen

Wanneer dit kenmerk wordt toegepast op een service-implementatieklasse, geeft dit kenmerk aan of deze service vereist of ondersteunt ASP.NET compatibiliteitsmodus moet worden ingeschakeld voor het hosttoepassingsdomein (AppDomain).

AppDomains die WCF-services hosten, kunnen worden uitgevoerd in twee verschillende hostingmodi:

• Modus Gemengde transporten (standaard): In deze modus nemen WCF-services niet deel aan de ASP.NET HTTP-pijplijn. Dit garandeert dat een WCF-service zich consistent gedraagt, onafhankelijk van de hostingomgeving en het transport.

• ASP.NET compatibiliteitsmodus: In deze modus nemen WCF-services deel aan de ASP.NET HTTP-pijplijn op een manier die vergelijkbaar is met ASMX-services. ASP.NET functies zoals bestandsautorisatie, UrlAuthorization en HTTP-sessiestatus zijn van toepassing op WCF-services die in deze modus worden uitgevoerd.

De hostingmodus wordt beheerd door de configuratievlag aspNetCompatibilityEnabledop toepassingsniveau.

<system.serviceModel>

<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>

</system.serviceModel>

Deze vlag is standaard false en dus worden WCF-services uitgevoerd in de modus Gemengde transporten, tenzij u expliciet kiest voor de ASP.NET compatibiliteitsmodus.

Zie <serviceHostingEnvironment> voor meer informatie over ASP.NET compatibiliteitsmodus.

Gebruik de RequirementsMode eigenschap om dit te doen. Tijdens runtime kunnen toepassingen detecteren of ASP.NET compatibiliteitsmodus is ingeschakeld door de waarde van de statische eigenschap AspNetCompatibilityEnabled te controleren.