Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Anmerkung
Dieser Artikel bezieht sich auf Azure Azure Cloud Services (erweiterter Support). Dieses Bereitstellungsmodell wird am 31. März 2027 eingestellt. Weitere Informationen finden Sie unter Azure-Updates.
Azure Cloud Services basiert in einigen Fällen auf Verbindungszeichenfolgen für die Authentifizierung, z. B. für Speicherkonten. Verbindungszeichenfolgen und Kennwörter sind aufgrund des Risikos unbeabsichtigter Gefährdung oder Kompromittierung inhärent unsicher. Microsoft empfiehlt die Verwendung von verwalteten Identitäten für die Authentifizierung und Dienste wie von Service Fabric verwaltete Cluster.
Um Daten in einer Azure-Tabelle zu filtern, die im Visual Studio Tabellen-Designerangezeigt wird, erstellen Sie eine Filterzeichenfolge, und geben Sie sie in das Filterfeld ein. Die Syntax der Filterzeichenfolge wird von wcf Data Services definiert und ähnelt einer SQL-WHERE-Klausel, wird aber über eine HTTP-Anforderung an den Tabellendienst gesendet. Der Tabellen-Designer die richtige Codierung für Sie verarbeitet. Um nach einem gewünschten Eigenschaftswert zu filtern, müssen Sie nur den Eigenschaftennamen, den Vergleichsoperator, den Kriterienwert und optional den booleschen Operator im Filterfeld eingeben. Sie müssen die $filter-Abfrage-Option nicht einfügen, wie Sie es tun würden, wenn Sie eine URL zum Abfragen der Tabelle über die Storage Services REST-API-Referenzerstellen würden.
WCF Data Services basiert auf dem Open Data Protocol (OData). Ausführliche Informationen zur Abfrageoption des Filtersystems ($filter) finden Sie in der Spezifikation OData-URI-Konventionen.
Vergleichsoperatoren
Die folgenden logischen Operatoren werden für alle Eigenschaftentypen unterstützt:
| Logischer Operator | Beschreibung | Filterzeichenfolge (Beispiel) |
|---|---|---|
| eq | Gleich | City eq 'Redmond' |
| gt | Größer als | Preis gt 20 |
| ge | Größer oder gleich | Preis ge 10 |
| lt | Kleiner als | Preis lt 20 |
| le | Kleiner oder gleich | Preis le 100 |
| NE | Ungleich | City ne 'London' |
| und | und | Preis le 200 and Preis gt 3,5 |
| oder | Or | Preis le 3,5 or Preis gt 200 |
| nicht | Nicht | nicht verfügbar |
Beim Erstellen einer Filterzeichenfolge sind die folgenden Regeln wichtig:
- Verwenden Sie die logischen Operatoren, um eine Eigenschaft mit einem Wert zu vergleichen. Es ist nicht möglich, eine Eigenschaft mit einem dynamischen Wert zu vergleichen. eine Seite des Ausdrucks muss eine Konstante sein.
- Bei allen Teilen der Filterzeichenfolge ist die Groß-/Kleinschreibung zu beachten.
- Der Konstantenwert muss demselben Datentyp entsprechen wie die Eigenschaft, damit der Filter gültige Ergebnisse zurückgibt. Weitere Informationen zu unterstützten Eigenschaftentypen finden Sie unter Grundlegendes zum Tabellendienst-Datenmodell.
Filtern nach Zeichenfolgeneigenschaften
Wenn Sie nach Zeichenfolgeneigenschaften filtern, schließen Sie die Zeichenfolgenkonstante in einfache Anführungszeichen ein.
Im folgenden Beispiel wird nach den Eigenschaften PartitionKey und RowKey gefiltert; zusätzliche Eigenschaften, die keine Schlüssel sind, können ebenfalls der Filterzeichenfolge hinzugefügt werden.
PartitionKey eq 'Partition1' and RowKey eq '00001'
Sie können jeden Filterausdruck in Klammern einschließen, obwohl er nicht erforderlich ist:
(PartitionKey eq 'Partition1') and (RowKey eq '00001')
Der Tabellendienst unterstützt keine Wildcardabfragen, und sie werden auch im Tabellen-Designer nicht unterstützt. Sie können jedoch präfixvergleichen, indem Sie Vergleichsoperatoren für das gewünschte Präfix verwenden. Im folgenden Beispiel werden Entitäten mit einer LastName-Eigenschaft zurückgegeben, die mit dem Buchstaben "A" beginnt:
LastName ge 'A' and LastName lt 'B'
Filtern nach numerischen Eigenschaften
Wenn Sie nach einer ganzzahligen Oder Gleitkommazahl filtern möchten, geben Sie die Zahl ohne Anführungszeichen an.
In diesem Beispiel werden alle Entitäten mit einer Age-Eigenschaft zurückgegeben, deren Wert größer als 30 ist:
Age gt 30
In diesem Beispiel werden alle Entitäten mit einer AmountDue-Eigenschaft zurückgegeben, deren Wert kleiner oder gleich 100,25 ist:
AmountDue le 100.25
Filtern nach booleschen Eigenschaften
Um nach einem booleschen Wert zu filtern, geben Sie true oder false ohne Anführungszeichen an.
Im folgenden Beispiel werden alle Entitäten zurückgegeben, in denen die IsActive-Eigenschaft auf truefestgelegt ist:
IsActive eq true
Sie können diesen Filterausdruck auch ohne den logischen Operator schreiben. Im folgenden Beispiel gibt der Tabellendienst auch alle Entitäten zurück, in denen IsActive trueist:
IsActive
Um alle Entitäten zurückzugeben, bei denen IsActive falsch ist, können Sie den operator not verwenden:
not IsActive
Filtern nach DateTime-Eigenschaften
Um nach einem DateTime-Wert zu filtern, geben Sie das datetime Schlüsselwort an, gefolgt von der Datums-/Uhrzeitkonstante in einfachen Anführungszeichen. Die Datums-/Uhrzeitkonstante muss im kombinierten UTC-Format vorliegen, wie in Formatierung von DateTime-Eigenschaftswertenbeschrieben.
Im folgenden Beispiel werden Entitäten zurückgegeben, bei denen die CustomerSince-Eigenschaft gleich dem 10. Juli 2008 ist:
CustomerSince eq datetime'2008-07-10T00:00:00Z'