Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Construction de chaînes de filtre pour le Concepteur de tables

Mis à jour: avril 2014

Pour filtrer des données d'une table Windows Azure s'affichant dans le Concepteur de tables Visual Studio, vous devez créer une chaîne de filtrage et la saisir dans le champ de filtre. La syntaxe de chaîne de filtrage est définie par les services de données WCF et est semblable à une clause SQL WHERE, à la différence qu'elle est envoyée au service de tables via une requête HTTP. Le Concepteur de tables gère l'encodage pour vous. Par conséquent, pour filtrer à l'aide de la valeur de propriété désirée, il vous suffit d'entrer le nom de la propriété, l'opérateur de comparaison, la valeur de critère, et éventuellement, l'opérateur booléen dans le champ de filtre. Vous n'avez pas besoin d'inclure l'option de requête de filtre comme vous le feriez si vous construisiez une URL pour interroger la table via Azure Storage Services REST API Reference.

Les services de données WCF sont basés sur le protocole Open Data (OData). Pour les détails sur l'option de requête du système du filtre ($filter), consultez les spécifications OData URI Conventions.

Opérateurs de comparaison

Les opérateurs logiques suivants sont pris en charge pour tous les types de propriétés :

 

Opérateur logique Description Exemple de chaîne de filtrage

eq

Égal

City eq 'Redmond'

gt

Supérieur à

Price gt 20

ge

Supérieur ou égal à

Price ge 10

lt

Inférieur à

Price lt 20

le

Inférieur ou égal

Price le 100

ne

Différent de

City ne 'London'

and

Et

Price le 200 and Price gt 3.5

- ou -

Ou

Price le 3.5 or Price gt 200

not

Non

not isAvailable

Lors de la construction d'une chaîne de filtrage, les règles suivantes sont importantes :

  • Utilisez des opérateurs logiques pour comparer une propriété à une valeur. Notez qu'il n'est pas possible de comparer une propriété à une valeur dynamique car l'un des côtés de l'expression doit être une constante.

  • Toutes les parties de la chaîne de filtrage respectent la casse.

  • La valeur de la constante doit être du même type de données que la propriété afin que le filtre puisse retourner des résultats valides. Pour plus d'informations sur les types de propriété pris en charge, consultez Understanding the Table Service Data Model.

Filtrage par propriétés de chaîne

Lorsque vous filtrez les propriétés de type chaîne, placez la constante de chaîne entre des guillemets simples.

L'exemple suivant filtre les propriétés PartitionKey et RowKey. D'autres propriétés ne correspondant pas à une clé peuvent également être ajoutées à la chaîne de filtrage :

PartitionKey eq 'Partition1' and RowKey eq '00001'

Vous pouvez mettre chaque expression de filtre entre parenthèses, même si cela n'est pas obligatoire :

(PartitionKey eq 'Partition1') and (RowKey eq '00001')

Notez que ni le service de tables, ni le Concepteur de tables ne prennent en charge les requêtes génériques. Toutefois, il est possible d'exécuter une correspondance de préfixe à l'aide d'opérateurs de comparaison sur le préfixe désiré. L'exemple suivant retourne des entités avec une propriété LastName commençant par la lettre A :

LastName ge 'A' and LastName lt 'B'

Filtrage par propriétés numériques

Pour filtrer par un nombre entier ou un nombre à virgule flottante, spécifiez le nombre sans guillemets.

Cet exemple retourne toutes les entités avec une propriété Age dont la valeur est supérieure à 30 :

Age gt 30

Cet exemple retourne toutes les entités avec une propriété AmountDue dont la valeur est inférieure ou égale à 100,25 :

AmountDue le 100.25

Filtrage par propriétés booléennes

Pour filtrer sur une valeur booléenne, spécifiez true ou false sans guillemets.

L'exemple suivant retourne toutes les entités où la propriété IsActive a la valeur true :

IsActive eq true

Vous pouvez également écrire cette expression de filtre sans opérateur logique. Dans l'exemple suivant, le service de tables retournera également toutes les entités où IsActive est true :

IsActive

Pour retourner toutes les entités où IsActive est false, vous pouvez utiliser l'opérateur not :

not IsActive

Filtrage par propriétés DateTime

Pour filtrer par valeur DateTime, spécifiez le mot clé datetime, suivi de la constante de date/heure entre guillemets simples. La constante de date/heure doit être au format UTC combiné, comme décrit dans Formatting the DateTime Property Values.

L'exemple suivant retourne des entités où la propriété CustomerSince est égale au 10 juillet 2008 :

CustomerSince eq datetime'2008-07-10T00:00:00Z'

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

Afficher:
© 2014 Microsoft. Tous droits réservés.