AspNetCompatibilityRequirementsAttribute AspNetCompatibilityRequirementsAttribute AspNetCompatibilityRequirementsAttribute AspNetCompatibilityRequirementsAttribute Class

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.Applied to a Windows Communication Foundation (WCF) service to indicate whether that service can be run in ASP.NET compatibility code.

public ref class AspNetCompatibilityRequirementsAttribute sealed : Attribute, System::ServiceModel::Description::IServiceBehavior
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class AspNetCompatibilityRequirementsAttribute : Attribute, System.ServiceModel.Description.IServiceBehavior
type AspNetCompatibilityRequirementsAttribute = class
    inherit Attribute
    interface IServiceBehavior
Public NotInheritable Class AspNetCompatibilityRequirementsAttribute
Inherits Attribute
Implements IServiceBehavior
Vererbung
AspNetCompatibilityRequirementsAttributeAspNetCompatibilityRequirementsAttributeAspNetCompatibilityRequirementsAttributeAspNetCompatibilityRequirementsAttribute
Attribute
Implementiert

Beispiele

Dienstentwickler können sicherstellen, dass der Dienst nur im ASP.NET-Kompatibilitätsmodus, durch Festlegen ausgeführt wird der RequirementsMode Eigenschaft der AspNetCompatibilityRequirementsAttribute zu Required wie im folgenden Beispiel gezeigt.Service developers can ensure that their service is only run in ASP.NET Compatibility Mode by setting the RequirementsMode property on the AspNetCompatibilityRequirementsAttribute to Required as shown in the following example

[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 dieses Attribut auf eine Dienstimplementierungsklasse angewendet wird, gibt es an, ob es dieser Dienst erfordert oder unterstützt, dass der ASP.NETASP.NET-Kompatibilitätsmodus für die Hostanwendungsdomäne (AppDomain) aktiviert wird.When applied to a service implementation class, this attribute indicates whether this service requires or supports ASP.NETASP.NET compatibility mode to be enabled for the hosting application domain (AppDomain).

Anwendungsdomänen Hosten von WCF-Diensten können in zwei verschiedenen hostingmodi ausgeführt:AppDomains hosting WCF services can run in two different hosting modes:

  • Gemischter Transporte-Modus (Standard): In diesem Modus werden WCF-Diensten keine Teilnahme der ASP.NETASP.NET HTTP-Pipeline.Mixed Transports Mode (Default): In this mode, WCF services do not participate in the ASP.NETASP.NET HTTP pipeline. Dadurch wird sichergestellt, dass ein WCF-Dienst verhält, konsistent und unabhängig von hostumgebung und Transport.This guarantees that a WCF service behaves consistently, independent of hosting environment and transport.

  • ASP.NETASP.NET Kompatibilitätsmodus: In diesem Modus werden WCF-Diensten teilnehmen die ASP.NETASP.NET HTTP-Pipeline, ähnlich wie ASMX-Dienste.Compatibility Mode: In this mode, WCF services participate in the ASP.NETASP.NET HTTP pipeline in a manner similar to ASMX services. ASP.NETASP.NET Funktionen wie Dateiautorisierung, Dateiautorisierung und HTTP-Sitzungsstatus sind anwendbar für WCF-Dienste, die in diesem Modus ausgeführt wird.features such as File Authorization, UrlAuthorization, and HTTP Session State are applicable to WCF services running in this mode.

Der Hostingmodus wird vom aspNetCompatibilityEnabled-Konfigurationsflag auf Anwendungsebene kontrolliert.The hosting mode is controlled by the application-level configuration flag aspNetCompatibilityEnabled.

<system.serviceModel>

<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>

</system.serviceModel>

Dieses Flag ist false standardmäßig und somit die WCF-Dienste ausführen im gemischten Transporte-Modus, es sei denn, Sie explizit auswählen der ASP.NETASP.NET im Kompatibilitätsmodus.This flag is false by default and thus WCF services run in the Mixed Transports Mode unless you explicitly opt into the ASP.NETASP.NET compatibility mode.

Weitere Informationen zum ASP.NET-Kompatibilitätsmodus finden Sie unter <ServiceHostingEnvironment>.For more informaiton about ASP.NET compatibility mode, see <serviceHostingEnvironment>.

Verwenden Sie dazu die RequirementsMode-Eigenschaft.Use the RequirementsMode property to do this. Zur Laufzeit können Anwendungen erkennen, ob der ASP.NETASP.NET-Kompatibilitätsmodus aktiviert ist, indem sie den Wert der statischen Eigenschaft AspNetCompatibilityEnabled prüfen.At runtime, applications can detect if ASP.NETASP.NET compatibility mode is enabled by checking the value of the static property AspNetCompatibilityEnabled.

Konstruktoren

AspNetCompatibilityRequirementsAttribute() AspNetCompatibilityRequirementsAttribute() AspNetCompatibilityRequirementsAttribute() AspNetCompatibilityRequirementsAttribute()

Initialisiert eine neue Instanz der AspNetCompatibilityRequirementsAttribute-Klasse.Initializes a new instance of the AspNetCompatibilityRequirementsAttribute class.

Eigenschaften

RequirementsMode RequirementsMode RequirementsMode RequirementsMode

Ruft den vom Dienst geforderten Grad der ASP.NETASP.NET-Kompatibilität vom Dienst ab oder legt diesen fest.Gets or sets the level of ASP.NETASP.NET compatibility required by the service.

TypeId TypeId TypeId TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Explizite Schnittstellenimplementierungen

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) 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.Adds custom data that the binding elements can access to support the implementation of the contract.

IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)

Prüft, ob der Hostingtyp die ASP.NETASP.NET-Kompatibilitätsanforderungen erfüllt.Checks that the type of hosting is consistent with the ASP.NETASP.NET compatibility requirements.

IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)

Überprüft das Dienstverhalten.Validates the service behavior.

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

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: