Freigeben über


AspNetCompatibilityRequirementsAttribute Klasse

Definition

Wird auf einen WCF-Dienst (Windows Communication Foundation) angewendet, um anzugeben, ob dieser Dienst in mit ASP.NET kompatiblem Code ausgeführt werden kann.

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
Vererbung
AspNetCompatibilityRequirementsAttribute
Attribute
Implementiert

Beispiele

Dienstentwickler können sicherstellen, dass ihr Dienst nur im ASP.NET Kompatibilitätsmodus ausgeführt wird, indem die RequirementsMode Eigenschaft auf der AspNetCompatibilityRequirementsAttribute Required im folgenden Beispiel gezeigten Eigenschaft festgelegt wird

[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

Hinweise

Wenn sie auf eine Dienstimplementierungsklasse angewendet wird, gibt dieses Attribut an, ob dieser Dienst ASP.NET Kompatibilitätsmodus benötigt oder unterstützt, der für die Hostinganwendungsdomäne (AppDomain) aktiviert werden soll.

AppDomains-Hosting-WCF-Dienste können in zwei verschiedenen Hostingmodi ausgeführt werden:

  • Gemischter Transportmodus (Standard): In diesem Modus nehmen WCF-Dienste nicht an der ASP.NET HTTP-Pipeline teil. Dadurch wird sichergestellt, dass sich ein WCF-Dienst konsistent verhält, unabhängig von Hostingumgebung und Transport.

  • ASP.NET Kompatibilitätsmodus: In diesem Modus nehmen WCF-Dienste an der ASP.NET HTTP-Pipeline teil, ähnlich wie ASMX-Dienste. ASP.NET Features wie Dateiautorisierung, UrlAuthorization und HTTP-Sitzungsstatus gelten für WCF-Dienste, die in diesem Modus ausgeführt werden.

Der Hostingmodus wird vom aspNetCompatibilityEnabled-Konfigurationsflag auf Anwendungsebene kontrolliert.

<system.serviceModel>

<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>

</system.serviceModel>

Dieses Kennzeichen ist false standardmäßig und damit WCF-Dienste im Gemischten Transportmodus ausgeführt, es sei denn, Sie entscheiden sich explizit für den Kompatibilitätsmodus ASP.NET.

Weitere Informationen zum ASP.NET Kompatibilitätsmodus finden Sie unter <serviceHostingEnvironment>.

Verwenden Sie dazu die RequirementsMode-Eigenschaft. Zur Laufzeit können Anwendungen erkennen, ob ASP.NET Kompatibilitätsmodus aktiviert ist, indem Sie den Wert der statischen Eigenschaft AspNetCompatibilityEnabledüberprüfen.

Konstruktoren

AspNetCompatibilityRequirementsAttribute()

Initialisiert eine neue Instanz der AspNetCompatibilityRequirementsAttribute-Klasse.

Eigenschaften

RequirementsMode

Dient zum Abrufen oder Festlegen der vom Dienst erforderlichen ASP.NET Kompatibilitätsebene.

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.

(Geerbt von Attribute)

Methoden

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.

(Geerbt von Attribute)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.

(Geerbt von Attribute)
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)

Fügt benutzerdefinierte Daten hinzu, auf die die Bindungselemente zugreifen können, um die Vertragsimplementierung zu unterstützen.

IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)

Überprüft, ob der Hostingtyp mit den ASP.NET Kompatibilitätsanforderungen übereinstimmt.

IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)

Überprüft das Dienstverhalten.

Gilt für