Ausdrucksoperatoren, Funktionen und Konstanten
In diesem Thema werden Operatoren und Funktionen aufgeführt, die vom Ausdrucks-Editor unterstützt werden. Außerdem werden Informationen dazu bereitgestellt, wie Konstanten in Ausdrücken angegeben werden können.
Die folgenden DevExpress-Produkte erweitern und/oder überschreiben diese Syntax. In der folgenden Tabelle sind die Artikel aufgeführt, in denen die Verwendung von Ausdrücken in diesen Produkten erläutert wird.
| Produkt | Artikel |
|---|---|
| Berichtend | Ausdruckskonstanten, Operatoren und Funktionen |
Betriebspersonal
| Operator | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| + | Addiert den Wert eines numerischen Ausdrucks zu einem anderen oder verkettet zwei Zeichenfolgen. | [Vorname] + ' ' + [Nachname]; [Stückpreis] + 4 | Ja |
| - | Ermittelt die Differenz zwischen zwei Zahlen. | [Preis1] - [Preis2] | Ja |
| * | Multipliziert den Wert zweier Ausdrücke. | [Menge] * [Stückpreis] * (1 - [BonusAmount]) | Ja |
| / | Teilt den ersten Operanden durch den zweiten. | [Menge] / 2 | Ja |
| % | Gibt den Rest (Modulus) zurück, der durch Division eines numerischen Ausdrucks in einen anderen erhalten wird. | [Menge] % 3 | Ja |
| | | Vergleicht jedes Bit seines ersten Operanden mit dem entsprechenden Bit seines zweiten Operanden. Wenn eines der Bits 1 ist, wird das entsprechende Ergebnisbit auf 1 gesetzt. Andernfalls wird das entsprechende Ergebnisbit auf 0 gesetzt. | [Anzahl] | [Anzahl] | Ja |
| & | Führt einen bitweisen logischen UND-Vorgang zwischen zwei ganzzahligen Werten aus. | [Anzahl] & 10 | Ja |
| ^ | Führt einen logischen Ausschluss für zwei boolesche Ausdrücke oder einen bitweisen Ausschluss für zwei numerische Ausdrücke aus. | [Zahl1] ^ [Zahl2] | Ja |
| == (sowie =) | Gibt true zurück, wenn beide Operanden denselben Wert haben. Andernfalls wird false zurückgegeben. | [Menge] == 10 (sowie [ID] = 11) | Ja |
| != | Gibt true zurück, wenn die Operanden nicht denselben Wert haben. Andernfalls wird false zurückgegeben. | [Land] != 'Frankreich' | Ja |
| < | Weniger als Operator. Wird zum Vergleichen von Ausdrücken verwendet. | [Stückpreis] < 20 | Ja |
| <= | Kleiner oder gleich Operator. Wird zum Vergleichen von Ausdrücken verwendet. | [Stückpreis] <= 20 | Ja |
| >= | Größer oder gleich Operator. Wird zum Vergleichen von Ausdrücken verwendet. | [Stückpreis] > 30 | Ja |
| > | Größer als Operator. Wird zum Vergleichen von Ausdrücken verwendet. | [Stückpreis] >= 30 | Ja |
| In (,,,) | Testet das Vorhandensein einer Eigenschaft in einem Objekt. | [Land] In ("USA", "UK", "Italien") | Ja |
| Mögen | Vergleicht eine Zeichenfolge mit einem Muster. Wenn der Wert der Zeichenfolge mit dem Muster übereinstimmt, ist das Ergebnis true. Wenn die Zeichenfolge nicht mit dem Muster übereinstimmt, ist result false. Wenn sowohl string als auch pattern leere Zeichenfolgen sind, ist das Ergebnis true. | [Vorname] Wie 'An%' | Ja |
| Zwischen (,) | Gibt einen zu testenden Bereich an. Gibt true zurück, wenn ein Wert größer oder gleich dem ersten Operanden und kleiner oder gleich dem zweiten Operanden ist. | [Menge] Zwischen (10, 20) | Ja |
| Und | Führt eine logische Konjunktion für zwei Ausdrücke aus. | [InStock] und ([ExtendedPrice]> 100) | Ja |
| Oder | Führt eine logische Disjunktion für zwei boolesche Ausdrücke aus. | [Land]=='USA' oder [Land]=='UK' | Ja |
| Nicht | Führt eine logische Negation für einen Ausdruck aus. | Nicht [InStock] | Ja |
| + | Gibt den Wert eines numerischen Ausdrucks zurück (ein unärer Operator). | +[Wert] = 10 | Ja |
| - | Gibt das Negativ des Werts eines numerischen Ausdrucks zurück (ein unärer Operator). | -[Wert] = 20 | Ja |
| ~ | Führt eine bitweise Negation für einen numerischen Ausdruck aus. | ~[Rollen] = 251 | - |
| Ist null | Gibt true zurück, wenn ein Ausdruck NULL ist, d. h. derjenige, der auf kein Objekt verweist. | [Region] ist null | ja |
Funktionen
Aggregatfunktionen
| Funktion | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| Durchschnitt(Wert) | Wertet den Durchschnitt der Werte in der Auflistung aus. | [Produkte]. Durchschn. ([Stückpreis]) | - |
| Anzahl() | Gibt die Anzahl der Objekte in einer Auflistung zurück. | [Produkte]. Anzahl() | - |
| Exists() | Bestimmt, ob das Objekt in der Auflistung vorhanden ist. | [Kategorien] [[Kategorie-ID] == 7]. Exists() | - |
| Max(Wert) | Gibt den maximalen Ausdruckswert in einer Auflistung zurück. | [Produkte]. Max([Stückpreis]) | - |
| Min(Wert) | Gibt den minimalen Ausdruckswert in einer Auflistung zurück. | [Produkte]. Min([Stückpreis]) | - |
| Einzel() | Gibt ein einzelnes Objekt aus einer Auflistung zurück, das nicht mehr als ein Objekt enthält. Wenn die Auflistung mehr Objekte enthält, verwenden Sie die Condition-Eigenschaft, um eine Bedingung anzugeben. Die Auflistung darf nur ein Objekt enthalten, das die Bedingung erfüllt. Andernfalls ist das Verhalten der Funktion nicht definiert (die Funktion kann einen unerwarteten Wert zurückgeben oder eine Ausnahme auslösen). Sie können einen Ausdruck als Parameter übergeben: [Collection][Condition]. Single(Ausdruck). Die Funktion gibt den Expression-Wert zurück, der für ein Objekt ausgewertet wird, das die angegebene Condition erfüllt (optional). | [Konten]. Single() ist nicht null [Collection]. Single([Property1]) - Gibt den Eigenschaftswert des gefundenen Objekts zurück. | - |
| Summe(Wert) | Gibt die Summe aller Ausdruckswerte in der Auflistung zurück. | [Produkte]. Summe([EinheitenInStock]) | - |
| Eine benutzerdefinierte Aggregatfunktion | Gibt einen benutzerdefinierten Ausdruckswert für eine Auflistung gemäß einer benutzerdefinierten Aggregatfunktion zurück. Sie können die Funktion direkt aufrufen oder als Parameter übergeben. | Aufrufen einer benutzerdefinierten Aggregatfunktion | - |
Datum-Uhrzeit-Funktionen
| Funktion | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| AddDays(DateTime, DaysCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Tagen entspricht, die von der angegebenen DateTime entfernt sind. | AddDays([OrderDate]30) | Ja |
| AddHours(DateTime, HoursCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Stunden entspricht, die von der angegebenen DateTime entfernt ist. | AddHours([StartZeit]2) | Ja |
| AddMilliSeconds(DateTime, MilliSecondsCount) | Gibt einen Datums-/Uhrzeitwert zurück, der die angegebene Anzahl von Millisekunden von der angegebenen DateTime entfernt ist. | AddMilliSeconds(([StartZeit]5000)) | - |
| AddMinutes(DateTime, MinutesCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Minuten von der angegebenen DateTime entfernt ist. | AddMinutes([StartZeit]30) | Ja |
| AddMonths(DateTime, MonthsCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Monaten entspricht, die von der angegebenen DateTime entfernt sind. | AddMonths([OrderDate]1) | Ja |
| AddSeconds(DateTime, SecondsCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Sekunden von der angegebenen DateTime entfernt ist. | AddSeconds([StartZeit]60) | Ja |
| AddTicks(DateTime, TicksCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Teilstrichen von der angegebenen DateTime entfernt ist. | AddTicks([StartZeit]5000) | - |
| AddTimeSpan(DateTime, TimeSpan) | Gibt einen Datums-/Uhrzeitwert zurück, der von der angegebenen DateTime für die angegebene TimeSpan abweicht. | AddTimeSpan([StartZeit];[Dauer]) | - |
| AddYears(DateTime, YearsCount) | Gibt einen Datums-/Uhrzeitwert zurück, der der angegebenen Anzahl von Jahren von der speziesfarbenen DateTime entfernt ist. | AddYears([EndDate]-1) | Ja |
| DateDiffDay(startDate, endDate) | Gibt die Anzahl der Tagesgrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffDay([StartTime], Now()) | Ja |
| DateDiffHour(startDate, endDate) | Gibt die Anzahl der Stundengrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffHour([StartTime], Now()) | Ja |
| DateDiffMilliSecond(startDate, endDate) | Gibt die Anzahl der Millisekundengrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffMilliSecond([StartTime], Now()) | - |
| DateDiffMinute(startDate, endDate) | Gibt die Anzahl der Minutengrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffMinute([StartTime], Now()) | Ja |
| DateDiffMonth(startDate, endDate) | Gibt die Anzahl der Monatsgrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffMonth([StartTime], Now()) | Ja |
| DateDiffSecond(startDate, endDate) | Gibt die Anzahl der Sekundengrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffSecond([StartTime], Now()) | Ja |
| DateDiffTick(startDate, endDate) | Gibt die Anzahl der Teilstrichgrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffTick([StartTime], Now()) | - |
| DateDiffYear(startDate, endDate) | Gibt die Anzahl der Jahresgrenzen zwischen zwei Datumsangaben zurück, die keine NULL-Werte zulassen. | DateDiffYear([StartTime], Now()) | Ja |
| GetDate(DateTime) | Extrahiert ein Datum aus der definierten DateTime. | GetDate([OrderDateTime]) | |
| GetDay(DateTime) | Extrahiert einen Tag aus der definierten DateTime. | GetDay([OrderDate]) | Ja |
| GetDayOfWeek(DateTime) | Extrahiert einen Wochentag aus der definierten DateTime. | GetDayOfWeek([OrderDate]) | Ja |
| GetDayOfYear(DateTime) | Extrahiert einen Tag des Jahres aus der definierten DateTime. | GetDayOfYear([OrderDate]) | Ja |
| GetHour(DateTime) | Extrahiert eine Stunde aus der definierten DateTime. | GetHour([Startzeit]) | Ja |
| GetMilliSecond(DateTime) | Extrahiert Millisekunden aus der definierten DateTime. | GetMilliSecond([Startzeit]) | - |
| GetMinute(DateTime) | Extrahiert Minuten aus der definierten DateTime. | GetMinute([Startzeit]) | Ja |
| GetMonth(DateTime) | Extrahiert einen Monat aus der definierten DateTime. | GetMonth([Startzeit]) | Ja |
| GetSecond(DateTime) | Extrahiert Sekunden aus der definierten DateTime. | GetSecond([StartZeit]) | Ja |
| GetTimeOfDay(DateTime) | Extrahiert die Uhrzeit aus der definierten DateTime in Ticks. | GetTimeOfDay([StartZeit]) | - |
| GetYear(DateTime) | Extrahiert ein Jahr aus der definierten DateTime. | GetYear([StartZeit]) | Ja |
| IsApril(DateTime) | Gibt True zurück, wenn das angegebene Datum in April liegt. | IsApril([Bestelldatum]) | Ja |
| IsAugust(DateTime) | Gibt True zurück, wenn das angegebene Datum in August liegt. | IsAugust([Bestelldatum]) | Ja |
| IsDecember(DateTime) | Gibt True zurück, wenn das angegebene Datum in Dezember liegt. | IsDecember([Bestelldatum]) | Ja |
| IsFebruar(DateTime) | Gibt True zurück, wenn das angegebene Datum in Februar liegt. | IsFebruar([Bestelldatum]) | Ja |
| IsJanuary(DateTime) | Gibt True zurück, wenn das angegebene Datum in Januar liegt. | IsJanuary([Bestelldatum]) | Ja |
| IsJuly(DateTime) | Gibt True zurück, wenn das angegebene Datum in Juli liegt. | IsJuly([Bestelldatum]) | Ja |
| IsJune(DateTime) | Gibt True zurück, wenn das angegebene Datum in Juni liegt. | IsJune([Bestelldatum]) | Ja |
| IsLastMonth(DateTime) | Gibt True zurück, wenn das angegebene Datum in den Vormonat fällt. | IsLastMonth([OrderDate]) | Ja |
| IsLastYear(DateTime) | Gibt True zurück, wenn das angegebene Datum in das Vorjahr fällt. | IsLastYear([OrderDate]) | Ja |
| IsMarch(DateTime) | Gibt True zurück, wenn das angegebene Datum in März liegt. | IsMarch([Bestelldatum]) | Ja |
| IsMay(DateTime) | Gibt True zurück, wenn das angegebene Datum in Mai liegt. | IsMay([Bestelldatum]) | Ja |
| IsNextMonth(DateTime) | Gibt True zurück, wenn das angegebene Datum in den nächsten Monat fällt. | IsNextMonth([OrderDate]) | Ja |
| IsNextYear(DateTime) | Gibt True zurück, wenn das angegebene Datum in das nächste Jahr fällt. | IsNextYear([OrderDate]) | Ja |
| IsNovember(DateTime) | Gibt True zurück, wenn das angegebene Datum in November liegt. | IsNovember([Bestelldatum]) | Ja |
| IsOctober(DateTime) | Gibt True zurück, wenn das angegebene Datum in Oktober liegt. | IsOctober([OrderDate]) | Ja |
| IsSameDay(DateTime) | Gibt True zurück, wenn die angegebenen Datums-/Uhrzeitwerte innerhalb desselben Tages liegen. | IsSameDay([OrderDate]) | Ja |
| IsSeptember(DateTime) | Gibt True zurück, wenn das angegebene Datum in September liegt. | IsSeptember([Bestelldatum]) | Ja |
| IsThisMonth(DateTime) | Gibt True zurück, wenn das angegebene Datum in den aktuellen Monat fällt. | IsThisMonth([OrderDate]) | Ja |
| IsThisWeek(DateTime) | Gibt True zurück, wenn das angegebene Datum in die aktuelle Woche fällt. | IsThisWeek([OrderDate]) | Ja |
| IsYearToDate(DateTime) | Gibt True zurück, wenn das angegebene Datum in den Zeitraum von Jahr bis heute fällt. Dieser Zeitraum beginnt am ersten Tag des laufenden Jahres und dauert bis zum aktuellen Datum (einschließlich des aktuellen Datums). | IsYearToDate([OrderDate]) | Ja |
| IsThisYear(DateTime) | Gibt True zurück, wenn das angegebene Datum in das aktuelle Jahr fällt. | IsThisYear([OrderDate]) | Ja |
| LocalDateTimeDayAfterTomorrow() | Gibt einen Datums-/Uhrzeitwert zurück, der dem Tag nach Morgen entspricht. | AddDays(LocalDateTimeDayAfterTomorrow(), 5) | Ja |
| LocalDateTimeLastMonth() | Gibt den DateTime-Wert zurück, der dem ersten Tag des Vormonats entspricht. | AddMonths(LocalDateTimeLastMonth(), 5) | Ja |
| LocalDateTimeLastWeek() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag der vorherigen Woche entspricht. | AddDays(LocalDateTimeLastWeek(), 5) | Ja |
| LocalDateTimeLastYear() | Gibt den DateTime-Wert zurück, der dem ersten Tag des Vorjahres entspricht. | AddYears(LocalDateTimeLastYear(), 5) | Ja |
| LocalDateTimeNextMonth() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag des nächsten Monats entspricht. | AddMonths(LocalDateTimeNextMonth(), 5) | Ja |
| LocalDateTimeNextWeek() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag der folgenden Woche entspricht. | AddDays(LocalDateTimeNextWeek(), 5) | Ja |
| LocalDateTimeNextYear() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag des folgenden Jahres entspricht. | AddYears(LocalDateTimeNextYear(), 5) | Ja |
| LocalDateTimeNow() | Gibt einen Datums-/Uhrzeitwert zurück, der dem aktuellen Zeitpunkt entspricht. | AddDays(LocalDateTimeNow(), 5) | Ja |
| LocalDateTimeThisMonth() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag des aktuellen Monats entspricht. | AddMonths(LocalDateTimeThisMonth(), 5) | Ja |
| LocalDateTimeThisWeek() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag der aktuellen Woche entspricht. | AddDays(LocalDateTimeThisWeek(), 5) | Ja |
| LocalDateTimeThisYear() | Gibt einen Datums-/Uhrzeitwert zurück, der dem ersten Tag des aktuellen Jahres entspricht. | AddYears(LocalDateTimeThisYear(), 5) | Ja |
| LocalDateTimeToday() | Gibt einen Datums-/Uhrzeitwert zurück, der dem Wert Heute entspricht. | AddDays(LocalDateTimeToday(), 5) | Ja |
| LocalDateTimeTomorrow() | Gibt einen Datums-/Uhrzeitwert zurück, der Tomorrow entspricht. | AddDays(LocalDateTimeTomorrow(), 5) | Ja |
| LocalDateTimeTwoMonthsAway() | Gibt den DateTime-Wert zurück, der dem ersten Tag des folgenden Monats entspricht. | AddMonths(LocalDateTimeTwoMonthAway(), 5) | Ja |
| LocalDateTimeTwoWeeksAway() | Gibt den DateTime-Wert zurück, der dem ersten Tag der folgenden Woche entspricht. | AddDays(LocalDateTimeTwoWeeksAway(), 5) | Ja |
| LocalDateTimeTwoYearsAway() | Gibt den DateTime-Wert zurück, der dem ersten Tag des folgenden Jahres entspricht. | AddYears(LocalDateTimeTwoYearsAway(), 5) | Ja |
| LocalDateTimeYearBeforeToday() | Gibt den DateTime-Wert zurück, der dem Tag vor einem Jahr entspricht. | AddYears(LocalDateTimeYearBeforeToday(), 5) | Ja |
| LocalDateTimeYesterday() | Gibt einen Datums-/Uhrzeitwert zurück, der Yesterday entspricht. | AddDays(LocalDateTimeYesterday(), 5) | Ja |
| Jetzt() | Gibt das aktuelle Systemdatum und die aktuelle Systemuhrzeit zurück. | AddDays(Now(), 5) | Ja |
| Heute() | Gibt das aktuelle Datum zurück. Unabhängig von der tatsächlichen Uhrzeit gibt diese Funktion Mitternacht des aktuellen Datums zurück. | AddMonths(Heute(), 1) | Ja |
| UtcNow() | Gibt das aktuelle Systemdatum und die aktuelle Systemuhrzeit zurück, ausgedrückt als koordinierte Weltzeit (UTC). | AddDays(UtcNow(), 7) | - |
Logische Funktionen
| Funktion | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| IIF(Ausdruck1, True_Value1, ..., AusdruckN, True_ValueN, False_Value) | Gibt abhängig von den Werten logischer Ausdrücke einen von mehreren angegebenen Werten zurück. Die Funktion kann 2N+1-Argumente annehmen (N - die Anzahl der angegebenen logischen Ausdrücke): Jedes ungerade Argument gibt einen logischen Ausdruck an; Jedes gerade-Argument gibt den Wert an, der zurückgegeben wird, wenn der vorherige Ausdruck als true ausgewertet wird. | Iif(Name = 'Bob', 1, 0) Iif(Name = 'Bob', 1, Name = 'Dan', 2, Name = 'Sam', 3, 0) | Ja |
| IsNull(Wert) | Gibt True zurück, wenn der angegebene Wert NULL ist. | IsNull([OrderDate]) | Ja |
| IsNull(Wert1, Wert2) | Gibt Value1 zurück, wenn er nicht auf NULL festgelegt ist. Andernfalls wird Value2 zurückgegeben. | IsNull([ShipDate;[RequiredDate]) | - |
| IsNullOrEmpty(String) | Gibt True zurück, wenn das angegebene String-Objekt NULL oder eine leere Zeichenfolge ist. Andernfalls wird False zurückgegeben. | IsNullOrEmpty([ProductName]) | Ja |
Mathematische Funktionen
| Funktion | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| Abs(Wert) | Gibt den absoluten, positiven Wert des angegebenen numerischen Ausdrucks zurück. | Abs(1 - [Rabatt]) | Ja |
| Acos(Wert) | Gibt den Arkussinus einer Zahl zurück (der Winkel im Bogenmaß, dessen Kosinus der angegebene Gleitkommaausdruck ist). | Acos([Wert]) | Ja |
| Asin(Wert) | Gibt den Arkussinus einer Zahl zurück (der Winkel im Bogenmaß, dessen Sinus der angegebene Gleitkommaausdruck ist). | Asin([Wert]) | Ja |
| Atn(Wert) | Gibt den Arkustangens einer Zahl zurück (den Winkel im Bogenmaß, dessen Tangente der angegebene Gleitkommaausdruck ist). | Atn([Wert]) | Ja |
| Atn2(Wert1, Wert2) | Gibt den Winkel zurück, dessen Tangente der Quotient zweier angegebener Zahlen im Bogenmaß ist. | Atn2([Wert1]; [Wert2]) | Ja |
| BigMul(Wert1, Wert2) | Gibt einen Int64-Wert zurück, der das vollständige Produkt von zwei angegebenen 32-Bit-Zahlen enthält. | BigMul([Betrag;[Menge]) | - |
| Obergrenze (Wert) | Gibt die kleinste ganze Zahl zurück, die größer oder gleich dem angegebenen numerischen Ausdruck ist. | Obergrenze([Wert]) | Ja |
| Cos(Wert) | Gibt den Kosinus des im Bogenmaß definierten Winkels zurück. | cos([Wert]) | Ja |
| Cosh(Wert) | Gibt den hyperbolischen Kosinus des im Bogenmaß definierten Winkels zurück. | Cosh([Wert]) | Ja |
| Exp(Wert) | Gibt den Exponentialwert des angegebenen Gleitkommaausdrucks zurück. | Exp([Wert]) | Ja |
| Boden (Wert) | Gibt die größte ganze Zahl zurück, die kleiner oder gleich dem angegebenen numerischen Ausdruck ist. | Etage([Wert]) | Ja |
| Log(Wert) | Gibt den natürlichen Logarithmus einer angegebenen Zahl zurück. | Log([Wert]) | Ja |
| Log(Wert, Basis) | Gibt den Logarithmus einer angegebenen Zahl in einer angegebenen Base zurück. | Log([Wert]2) | Ja |
| Log10(Wert) | Gibt den Logarithmus zur Basis 10 einer angegebenen Zahl zurück. | log10([Wert]) | Ja |
| Max(Wert1, Wert2) | Gibt den Maximalwert aus den angegebenen Werten zurück. | Max([Wert1;[Wert2]) | Ja |
| Min(Wert1, Wert2) | Gibt den Mindestwert aus den angegebenen Werten zurück. | Min([Wert1;[Wert2]) | Ja |
| Leistung (Wert, Leistung) | Gibt eine angegebene Zahl zurück, die auf eine angegebene Potenz erhöht wird. | Leistung([Wert]3) | Ja |
| Rnd() | Gibt eine Zufallszahl zurück, die kleiner als 1, aber größer oder gleich Null ist. | Rnd()*100 | Ja |
| Runden(Wert) | Rundet den angegebenen Wert auf die nächste ganze Zahl. | Runden([Wert]) | Ja |
| Vorzeichen(Wert) | Gibt das positive (+1), Null- (0) oder negative (-1)-Zeichen des angegebenen Ausdrucks zurück. | Vorzeichen([Wert]) | Ja |
| Sünde(Wert) | Gibt den Sinus des Winkels zurück, der im Bogenmaß definiert ist. | Sünde([Wert]) | Ja |
| Sinh(Wert) | Gibt den hyperbolischen Sinus des im Bogenmaß definierten Winkels zurück. | Sinh([Wert]) | Ja |
| sqr(Wert) | Gibt die Quadratwurzel einer gegebenen Zahl zurück. | sqr([Wert]) | - |
| Tan (Wert) | Gibt die Tangente des im Bogenmaß definierten Winkels zurück. | Tan([Wert]) | Ja |
| Tanh(Wert) | Gibt die hyperbolische Tangente des im Bogenmaß definierten Winkels zurück. | Tanh([Wert]) | Ja |
| ToDecimal(Wert) | Konvertiert Value in eine äquivalente Dezimalzahl. | ToDecimal([Wert]) | - |
| ToDouble(Wert) | Konvertiert Value in eine äquivalente 64-Bit-Gleitkommazahl mit doppelter Genauigkeit. | ToDouble([Wert]) | - |
| ToFloat(Wert) | Konvertiert Value in eine äquivalente 32-Bit-Gleitkommazahl mit einfacher Genauigkeit. | ToFloat([Wert]) | - |
| ToInt(Wert) | Konvertiert Value in eine entsprechende 32-Bit-Ganzzahl mit Vorzeichen. | ToInt([Wert]) | - |
| ToLong(Wert) | Konvertiert Value in eine entsprechende 64-Bit-Ganzzahl mit Vorzeichen. | ToLong([Wert]) | - |
String-Funktionen
| Funktion | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| Ascii(Zeichenfolge) | Gibt den ASCII-Codewert des Zeichens ganz links in einem Zeichenausdruck zurück. | Ascii('a') | - |
| Zeichen(Zahl) | Konvertiert einen integerASCIICode in ein Zeichen. | Zeichen(65) + Zeichen(51) | Ja |
| CharIndex(Zeichenfolge1, Zeichenfolge2) | Gibt die Startposition von String1 innerhalb von String2 zurück, beginnend mit der Nullzeichenposition bis zum Ende einer Zeichenfolge. | CharIndex('e', 'devexpress') | - |
| CharIndex(Zeichenfolge1, Zeichenfolge2, StartLocation) | Gibt die Startposition von String1 innerhalb von String2 zurück, beginnend mit der StartLocation-Zeichenposition bis zum Ende einer Zeichenfolge. | CharIndex('e', 'devexpress', 2) | - |
| Concat(Zeichenfolge1, ... , ZeichenfolgeN) | Gibt das Ergebnis der Verkettung von zwei oder mehr Zeichenfolgenwerten zurück. | Concat('A', ')', [ProductName]) | Ja |
| Enthält(String1, SubString1) | Gibt True zurück, wenn SubString1 innerhalb von String1 vorkommt; Andernfalls wird False zurückgegeben. | Enthält([ProductName], 'Molkerei') | Ja |
| EndsWith(String1, SubString1) | Gibt True zurück, wenn das Ende von String1 mit SubString1 übereinstimmt. Andernfalls wird False zurückgegeben. | EndsWith([Beschreibung]] 'Das Ende.') | Ja |
| Einfügen(Zeichenfolge1, StartPosition, Zeichenfolge2) | Fügt String2 an der von StartPositon angegebenen Position in String1 ein | Einfügen([Name]0, 'ABC-') | - |
| Len(Wert) | Gibt eine ganze Zahl zurück, die entweder die Anzahl der Zeichen in einer Zeichenfolge oder die nominale Anzahl von Bytes enthält, die zum Speichern einer Variablen erforderlich sind. | Len([Beschreibung]) | Ja |
| Lower(String) | Gibt String in Kleinbuchstaben zurück. | Lower([ProductName]) | Ja |
| PadLeft(Zeichenfolge, Länge) | Richtet Zeichen in der definierten Zeichenfolge linksbündig aus und füllt die linke Seite mit Leerzeichen bis zu einer angegebenen Gesamtlänge auf. | - | |
| PadLeft(Zeichenfolge, Länge, Zeichen) | Richtet Zeichen in der definierten Zeichenfolge linksbündig aus, wobei die linke Seite bis zu einer angegebenen Gesamtlänge mit dem angegebenen Char aufgefüllt wird. | PadLeft([Name], 30, '<') | - |
| PadRight(Zeichenfolge, Länge) | Richtet Zeichen in der definierten Zeichenfolge rechtsbündig aus, wobei die linke Seite bis zu einer angegebenen Gesamtlänge mit Leerzeichen aufgefüllt wird. | PadRight([Name], 30) | - |
| PadRight(String, Length, Char) | Richtet Zeichen in der definierten Zeichenfolge rechtsbündig aus, wobei die linke Seite bis zu einer angegebenen Gesamtlänge mit dem angegebenen Char aufgefüllt wird. | PadRight([Name], 30, '>') | - |
| Remove(String, StartPosition, Length) | Löscht eine angegebene Anzahl von Zeichen aus dieser Instanz, beginnend an einer angegebenen Position. | Entfernen([Name]0;3) | - |
| Ersetzen(String, SubString2, String3) | Gibt eine Kopie von String1 zurück, in der SubString2 durch String3 ersetzt wurde. | Replace([Name], 'Die ', '') | - |
| Reverse(String) | Kehrt die Reihenfolge der Elemente innerhalb von String um. | Reverse([Name]) | - |
| StartsWith(String1, SubString1) | Gibt True zurück, wenn der Anfang von String1 mit SubString1 übereinstimmt. andernfalls False. | StartsWith([Titel]], 'Das Beste') | Ja |
| Teilzeichenfolge(Zeichenfolge, StartPosition, Länge) | Ruft eine Teilzeichenfolge aus String ab. Die Teilzeichenfolge beginnt an StartPosition und hat die angegebene Length. | Teilzeichenfolge([Beschreibung]2; 3) | Ja |
| Teilzeichenfolge(Zeichenfolge, StartPosition) | Ruft eine Teilzeichenfolge aus String ab. Die Teilzeichenfolge beginnt an StartPosition. | Teilzeichenfolge([Beschreibung]2) | - |
| ToStr(Wert) | Gibt eine Zeichenfolgendarstellung eines Objekts zurück. | ToStr([ID]) | - |
| Zuschneiden(Zeichenfolge) | Entfernt alle führenden und nachgestellten LEERZEICHEN aus String. | Zuschneiden([Produktname]) | Ja |
| Upper(String) | Gibt String in Großbuchstaben zurück. | Upper([Produktname]) | Ja |
Konstanten
| Konstante | Beschreibung | Beispiel | XLS(x)-Format Exportfreundlich *Siehe Hinweis |
|---|---|---|---|
| Zeichenfolgenkonstanten | Zeichenfolgenkonstanten müssen in Apostrophe umschlossen werden. | [Land] == 'Frankreich' | Ja |
| String-Konstanten (mit Apostroph) | Wenn eine Zeichenfolge einen Apostroph enthält, muss der Apostroph verdoppelt werden. | [Name] == 'O''Neil' | Ja |
| Datum-/Uhrzeit-Konstanten | Datums-/Uhrzeitkonstanten müssen in '#' eingeschlossen werden. | [OrderDate] >= 01.01.2009# | Ja |
| STIMMT | Stellt den booleschen True-Wert dar. | [InStock] == Wahr | Ja |
| FALSE | Stellt den booleschen False-Wert dar. | [InStock] == Falsch | Ja |
| ? | Stellt einen NULL-Verweis dar, der auf kein Objekt verweist. Es wird empfohlen, stattdessen den unären IsNull-Operator (z. B. "[Region] ist null") oder die logische IsNull-Funktion (z. B. "IsNull([Region])) zu verwenden. | [Region] != ? | Ja |
| Aufzählung | Geben Sie einen Enumerationswert mit dem zugrunde liegenden ganzzahligen Wert an. | [Status] == 1 | |
| Guid | Wickeln Sie eine Guid-Konstante in geschweifte Klammern. Verwenden Sie Guid-Konstanten in einem relationalen Vorgang nur mit Gleichheits- oder Ungleichheitsoperatoren. | [OrderID] == {513724e5-17b7-4ec6-abc4-0eae12c72c1f} | Ja |
| Numerisch | Geben Sie verschiedene numerische Konstantentypen in einer Zeichenfolgenform mithilfe von Suffixen an: * Int32 (int ) - 1 * Int16 (kurz) - 1s * Byte (Byte) - 1b * Doppel (doppelt) - 1.0 * Single (float) - 1.0f * Dezimal (dezimal) - 1.0m |
[Preis] == 25.0m | Ja |
Sie können parametrisierte Kriterien mit beliebig vielen Positionsparametern erstellen. Fügen Sie dazu einem Kriterienausdruck Parameterplatzhalter (Fragezeichenzeichen) hinzu, um Parameterpositionen zu identifizieren und eine Liste von Parameterwerten bereitzustellen. Beim Erstellen von Kriterien werden Parameterplatzhalter durch Parameterwerte in der angegebenen Reihenfolge ersetzt.
CriteriaOperator.Parse("[Name] == ? und [Alter] == ?", "John", 33)
Die folgenden beiden Beispiele sind identisch, aber das zweite ermöglicht es Ihnen, Formatierungsfehler zu vermeiden.
CriteriaOperator.Parse("[OrderDate] >= #1/1/2009#")
CriteriaOperator.Parse("[OrderDate] >= ?", new DateTime(2009, 1, 1))
Wenn keine Parameter angegeben werden, wird ein Parameterplatzhalter durch null ersetzt.
CriteriaOperator.Parse("[Region] != ?")
Überprüfung von Sammlungselementen
Verwenden Sie eckige Klammern "[]", um zu überprüfen, ob eine Auflistung ein Element enthält, das eine Bedingung erfüllt. Der folgende Ausdruck gibt true zurück, wenn die Accounts-Auflistung mindestens ein Element enthält, das die Bedingung [Amount] == 100 erfüllt:
[Konten][[Betrag] == 100]
Der folgende Ausdruck gibt false zurück, wenn die Accounts-Auflistung leer ist:
[Konten][]
Übergeordneter Operator
Verwenden Sie den übergeordneten Beziehungsoperator ('^'-Zeichen), um in Ausdrücken, die im Kontext eines untergeordneten Elements geschrieben wurden, auf ein übergeordnetes Element zu verweisen. Sie können diesen Operator nacheinander anwenden, um durch mehrere übergeordnete Beziehungen zu navigieren. Im folgenden Ausdruck bezieht sich das Feld "RegistrationDate" auf einen Kunden (das übergeordnete Element von Orders) und das Feld "Date" auf Bestellungen. Dieser Ausdruck gibt true zurück, wenn mindestens eine Bestellung am Tag der Registrierung des übergeordneten Kunden getätigt wird:
"[Bestellungen][[^. RegistrationDate] == Datum]"
Gruppieren von Klauseln mit eckigen Klammern
Es ist wichtig, eckige Klammern zu verwenden, um sicherzustellen, dass der Ausdruck die beabsichtigten Ergebnisse zurückgibt. Der folgende Ausdruck gibt beispielsweise für Objekte des Typs Customer alle Kunden zurück, bei denen ein Konto mit dem Datum 25.08.2006 und ein Konto mit dem Betrag 100 vorhanden ist:
[Konten][[Datum] == #25.08.2006#] && [Konten][[Betrag] == 100]
Erstellen Sie den Ausdruck wie im folgenden Beispiel, um nach allen Kunden zu suchen, die ein Konto mit einem Datum von 25.08.2006 und einem Betrag von 100 haben:
[Konten][[Datum] == #25.08.2006# && [Betrag] == 100]
Operator-Rangfolge
Wenn ein Ausdruck mehrere Operatoren enthält, steuert deren Rangfolge die Reihenfolge, in der Ausdruckselemente ausgewertet werden.
- Literale Werte
- Parameter
- Bezeichner
- OR (linksassoziativ)
- UND (linksassoziativ)
- '.' Beziehungsqualifizierer (linksassoziativ)
- ==, !=
- <, >, <=, >=
- -, + (linksassoziativ)
- *, /, % (linksassoziativ)
- NICHT
- unär-
- In
- Iif
- Trim(), Len(), Substring(), IsNull()
- '[]' (für Set-Beschränkung)
- '()'
Die Standardpriorität kann geändert werden, indem Elemente mit Klammern gruppiert werden. Beispielsweise werden die Operatoren im ersten der folgenden beiden Codebeispiele in einer Standardreihenfolge ausgeführt. Im zweiten Codebeispiel wird zuerst der Additionsvorgang ausgeführt, da die zugeordneten Elemente in Klammern gruppiert sind und der Multiplikationsvorgang zuletzt ausgeführt wird.
Accounts[Betrag == 2 + 48 * 2]
Accounts[Anzahl == (2 + 48) * 2]
Groß-/Kleinschreibung
Bei Operatoren wird nicht zwischen Groß- und Kleinschreibung unterschieden. Obwohl die Groß-/Kleinschreibung von Feldwerten von der Datenquelle abhängt.
[! ANMERKUNG] Eine Datenquelle beeinflusst das Verhalten bestimmter Operatoren. Beispielsweise kann eine Datenquelle so konfiguriert werden, dass die Groß-/Kleinschreibung nicht beachtet wird. In diesem Fall wird der folgende Ausdruck immer als true ausgewertet: Lower(Name) == Upper(Name)
Escape-Schlüsselwörter
Sie können einen schlüsselwortähnlichen Feldnamen mit einem Escapezeichen (@-Zeichen) markieren. Im folgenden Ausdruck interpretiert die CriteriaOperator.Parse-Methode @Or als das Feld mit dem Namen "Or", nicht als den logischen Operator OR.
@Or = 'Wert'
Escape-Charaktere
Verwenden Sie einen umgekehrten Schrägstrich () als Escapezeichen für Zeichen in Ausdrücken. Beispiele:
- \[
- \\
- \'
Abrufen von Verweiseigenschaften
Beachten Sie, dass ein Kriterienausdruck zwar einen Objektverweis zurückgeben kann, dies jedoch nicht in allen Szenarien unterstützt wird. Das Zurückgeben eines Objektverweises durch direktes Verweisen auf eine Eigenschaft, wie im folgenden Codeausschnitt gezeigt, wird vollständig unterstützt.
"IIF(Part is null, MyCustOrderLine.Part, Part)"
In diesem Codeausschnitt wird das Part-Objekt, auf das die Part-Eigenschaft oder die MyCustOrderLine.Part-Eigenschaft verweist, ordnungsgemäß zurückgegeben. Das Abrufen von Verweiseigenschaften aus Funktionen wird jedoch nicht unterstützt. Daher funktioniert der folgende Ausdruck nicht.
"IIF(Part is null, MyCustOrderLine, MyCustOrderLine2). Teil"
Hinweis - Einschränkungen
Beachten Sie die folgende Einschränkung beim Exportieren von DevExpress-Datenraster- und Strukturlistensteuerelementen (WinForms und WPF) in das XLS(X)-Format im Data-Aware Export Mode:
Nur Ausdrücke, die exportfreundliche Funktionen enthalten, werden in das XLS(X)-Format exportiert. In der Spalte XLS(x) Format Exportfreundlich in den obigen Tabellen finden Sie heraus, ob eine Funktion in das XLS(x)-Format exportiert werden kann.