QueryInterceptorAttribute Classe

Définition

Espace de noms:

System.Data.Services

Assembly:

System.Data.Services.dll

Le QueryInterceptorAttribute sur une méthode l'annote comme intercepteur de requête sur le jeu d'entités spécifié.

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

Héritage

Object

Attribute

QueryInterceptorAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant contrôle l’accès au jeu d’entités Customers . Chacun Customer peut uniquement voir Orders associé à ce Customer.

[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  
              );  
}  

Remarques

L’autorisation et la validation au niveau du jeu d’entités sont implémentées par des méthodes annotées avec le QueryInterceptorAttribute. Les services de données WCF n’implémentent pas de stratégies de sécurité, mais fournissent plutôt l’infrastructure requise pour que les développeurs de services écrivent leurs propres règles de sécurité et validation métier.

Le contrôle d’accès et la validation du jeu d’entités sont activés par le biais d’opérations de requête à l’aide de la composition de requête. Pour contrôler l’accès basé sur les entités, implémentez un jeu de méthodes par entité conformément aux règles suivantes :

La méthode doit avoir une étendue publique et être annotée avec , QueryInterceptorAttributeen prenant le nom d’un jeu d’entités comme paramètre.

La méthode ne doit accepter aucun paramètre.

La méthode doit retourner une expression de type Expression<Func<T, bool>> qui est le filtre à composer pour le jeu d’entités.

Constructeurs

QueryInterceptorAttribute(String)

Initialise une nouvelle instance de la classe QueryInterceptorAttribute pour le jeu d'entités spécifié par le paramètre entitySetName.

Propriétés

EntitySetName	Obtient le nom du jeu d'entités qui contient l'entité à laquelle s'applique l'intercepteur.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Attribute)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)