SetFilterDirectSQL

Beschreibung:

Erstellt einen Filter auf Basis des übergebenen freien Filterausdruckes. Beachten Sie auch gerne die Informationen zur empfohlenen Vorgehensweise im Kapitel Ausführen eines Filters.

Hinweis: In der Abfrage muss generell im SELECT-Teil die Primärschlüsselspalte der zum RecordSet gehörenden Tabelle selektiert werden, der restliche Aufbau der Abfrage ist beliebig.

Wichtig: Es sollten zuvor alle etwaig geholten Record-Objekte auf Nothing gesetzt werden, keinesfalls dürfen sie anschließend noch verwendet werden.

Parameter:

Parametername

Typ

Beschreibung

sSQLQuery

String

Freier SQL Filterausdruck.

bUseCurrentQuery (Optional)

Bool

True: Der Filter basiert auf dem aktuell bestehenden Filter.

False (Voreinstellung): Es wird ein neuer Filter erstellt.

Rückgabewert:

Bool

Wert	Beschreibung
True	Filter konnte erstellt werden. Alle gefilterten Datensätze sind ab diesem Zeitpunkt im verwendeten RecordSet-Objekt enthalten, der Filter muss aber nicht zwingend Datensätze enthalten.
False	Filter konnte nicht ausgeführt werden. Prüfen Sie ggf. Debwin auf Fehlerausgaben des Datenbanksystems.

Beispiel VBScript:

' Dieses Beispiel basiert auf der Kontakte-Ansicht einer combit_Large-Solution

Call cRM.CurrentProject.ActiveViews.ActiveView.CurrentRecordSet.SetFilterDirectSQL("SELECT Contacts.ID FROM Contacts WHERE Salutation = 'Herrn'", True)

Beispiel C#-Script:

// Dieses Beispiel basiert auf der Kontakte-Ansicht einer combit_Large-Solution

cRM.CurrentProject.ActiveViews.ActiveView.CurrentRecordSet.SetFilterDirectSQL("SELECT Contacts.ID FROM Contacts WHERE Salutation = //Herrn//", true);