QueryInterceptorAttribute Klasse

Definition

Namespace:

System.Data.Services

Assembly:

System.Data.Services.dll

Das QueryInterceptorAttribute in einer Methode kennzeichnet diese als Abfrageinterceptor im angegebenen Entitätssatz.

public ref class QueryInterceptorAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=true, Inherited=true)]
public sealed class QueryInterceptorAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=true, Inherited=true)>]
type QueryInterceptorAttribute = class
    inherit Attribute

Public NotInheritable Class QueryInterceptorAttribute
Inherits Attribute

Vererbung

Object

Attribute

QueryInterceptorAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird der Zugriff auf den Customers Entitätssatz kontrolliert. Jede Customer kann nur sehen, die diesem zugeordnet Orders Customer ist.

[QueryInterceptor("Orders")]  
public Expression<Func<Order, bool>> FilterOrders()   
{  
    return o => o.Customer.Name == /* Current principal name. */;  
}   

// Insures that the user accessing the customer(s) has the appropriate  
// rights as defined in the QueryRules object to access the customer  
// resource(s).  

[QueryInterceptor ("Customers")]  
public Expression<Func<Customer, bool>> FilterCustomers()   
{  
  return c => c.Name == /* Current principal name. */ &&  
              this.CurrentDataSource.QueryRules.Contains(  
                rule => rule.Name == c.Name &&  
                        rule.CustomerAllowedToQuery == true  
              );  
}  

Hinweise

Autorisierung und Validierung auf Entitätssatzebene werden durch Methoden implementiert, die mit dem kommentiert QueryInterceptorAttribute sind. WCF Data Services implementieren keine Sicherheitsrichtlinien, sondern stellen stattdessen die Infrastruktur zur Verfügung, die Dienstentwickler benötigen, um ihre eigenen Sicherheitsregeln und Geschäftsvalidierung zu schreiben.

Die Zugriffssteuerung und -validierung von Entitäten wird über Abfragevorgänge mithilfe der Abfragekomposition aktiviert. Implementieren Sie zum Steuern des entitätsbasierten Zugriffs einen Methodensatz pro Entität gemäß den folgenden Regeln:

Die Methode muss einen öffentlichen Bereich haben und mit dem kommentiert werden. Dabei wird der Name einer Entität als QueryInterceptorAttribute Parameter verwendet.

Die -Methode darf keine Parameter akzeptieren.

Die -Methode muss einen Ausdruck vom Typ Expression<Func<T, bool>> zurückgeben, der der Filter ist, der für den Entitätssatz zusammengesetzt werden soll.

Konstruktoren

QueryInterceptorAttribute(String)

Initialisiert eine neue Instanz der QueryInterceptorAttribute-Klasse für den Entitätssatz, der vom entitySetName-Parameter angegeben wird.

Eigenschaften

EntitySetName	Ruft den Namen des Entitätssatzes ab, der die Entität enthält, für die der Interceptor gilt.
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)