Filtern eines benutzerdefinierten Felds

Artikel
04/07/2023

Sie können benutzerdefinierte Eigenschaften in Filtern mit Microsoft Jet-Syntax oder DASL-Syntax (DAV Searching and Locating) angeben. Die benutzerdefinierten Eigenschaften müssen in dem Ordner definiert sein, in dem Sie den Filter anwenden. Wenn die benutzerdefinierten Eigenschaften nur im Element definiert sind, schlägt die Suche fehl.

Jet-Abfragen

Benutzerdefinierte Eigenschaften können Leerzeichen im Eigenschaftennamen enthalten. Schließen Sie in einer Jet-Abfrage, wie in allen Eigenschaftennamensverweisen, einfach den Namen der benutzerdefinierten Eigenschaft in eckige Klammern ein. Die folgende Jet-Abfrage ruft beispielsweise alle Kontakte ab, bei denen die benutzerdefinierte Eigenschaft "Preferred Gift" genau "Diamonds" ist. Damit die Abfrage erfolgreich ist, wurde die benutzerdefinierte Eigenschaft "Preferred Gift" in dem Ordner definiert, der die benutzerdefinierten Kontaktelemente enthält:

criteria = "[Preferred Gift] = 'Diamonds'"

DASL-Abfragen

Wenn in einer DASL-Abfrage der Name einer benutzerdefinierten Eigenschaft Leerzeichen enthält, müssen Sie die URL-Codierung (Uniform Resource Locator) auf die einzelnen Leerzeichen anwenden und das Leerzeichen durch "%20" ersetzen. Im Allgemeinen gilt für Zeichen in einer DASL-Abfrage die gleiche URL-Codierung wie für Zeichen in einer URL.

Wenn Sie eine DASL-Abfrage für eine benutzerdefinierte Eigenschaft erstellen, müssen Sie die Namespace-GUID für benutzerdefinierte Outlook-Eigenschaften im folgenden Format verwenden:

https://schemas.microsoft.com/mapi/string/{GUID}/PropertyName

Dabei entspricht {GUID} der folgenden GUID:

{00020329-0000-0000-C000-000000000046}

Filtern von benutzerdefinierten Eigenschaften, auf die über den MAPI-Namespace "string" verwiesen wird

If the custom property you are filtering for does not exist in the UserDefinedProperties collection for the folder, and if you are referencing the custom property by the MAPI string namespace, then you must explicitly append a type specifier to the namespace representation of the custom property. Note that you need to specify the type only when applying a DASL filter to search and filter entry points in the Items collection and the Table object, and to the Application.AdvancedSearch method.

Hinweis Der sechseckige Typspezifizierer muss die Form 0000HHHHH mit nur 8 Ziffern im Gegensatz zu 9 haben. Weitere Informationen zu den sechseckigen Typspezifizierern (HHHH) für verschiedene MAPI-Typen finden Sie unter Eigenschaftentypen.

For example, if you want to use Items.Restrict to search for the custom Unicode string property named "MyProperty" and this property does not exist in the UserDefinedProperties collection for the folder, you must append the Unicode string type specifier, 0000001f, to the representation of the property in the MAPI string namespace:

criteria = "@SQL=" & Chr$(34) & "https://schemas.microsoft.com/mapi/string/" _ 
& "{00020329-0000-0000-C000-000000000046}/MyProperty"_ 
& "/0000001f" & Chr(34) & " = '12-74440'"

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Share via