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

Beispiele

Dienst Entwickler können sicherstellen, dass Ihr Dienst nur im ASP.NET-Kompatibilitätsmodus ausgeführt RequirementsMode wird, indem AspNetCompatibilityRequirementsAttribute Sie Required die-Eigenschaft auf dem auf festlegen, 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).

Anwendungs Domänen, die WCF-Dienste Hosting, können in zwei verschiedenen Hostingmodi ausgeführt werdenAppDomains hosting WCF services can run in two different hosting modes:

  • Gemischter Transportmodus (Standard): In diesem Modus nehmen die WCF-Dienste nicht an der ASP.NETASP.NET HTTP-Pipeline Teil.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 unabhängig von der Hostingumgebung und dem Transport konsistent verhält.This guarantees that a WCF service behaves consistently, independent of hosting environment and transport.

  • ASP.NETASP.NETKompatibilitätsmodus: In diesem Modus nehmen die WCF-Dienste an ASP.NETASP.NET der HTTP-Pipeline ähnlich wie ASMX-Dienste Teil.Compatibility Mode: In this mode, WCF services participate in the ASP.NETASP.NET HTTP pipeline in a manner similar to ASMX services. ASP.NETASP.NETFunktionen wie Datei Autorisierung, urlauthorisierung und http-Sitzungs Status gelten für WCF-Dienste, die in diesem Modus ausgeführt werden.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 daher werden WCF-Dienste im gemischten Transportmodus ausgeführt, es sei denn ASP.NETASP.NET , Sie entscheiden sich explizit für den 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 servicehoststingenvironment>.For more information 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()

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

Eigenschaften

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

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.

(Geerbt von Attribute)

Methoden

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.

(Geerbt von Attribute)
GetHashCode()

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

(Geerbt von Attribute)
GetType()

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

(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.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(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.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Geerbt von Attribute)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_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.

(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.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Geerbt von Attribute)
_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).

(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.Provides access to properties and methods exposed by an object.

(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.Adds custom data that the binding elements can access to support the implementation of the contract.

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)

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

Gilt für: