Description
Assigns a Category (string) that must be related to those in the McDBNode.Categories collection of McDBNode instances returned by this McDBQuery.
-
Return Type
-
None
-
Syntax
-
object.SetCategory Category, [CompOp]
The SetCategory Method syntax has these parts: |
| object | An expression evaluating to an object of type McDBQuery. | | Category | Required. A String value. | | CompOp | Optional. A mcDBCompOp enumeration, as described in settings. How one or more categories of the result McDBNode instances will compare to Name.
|
Settings The settings for CompOp are:
|
 | mcdbEQ | 1 |
Equality (default)
|
| mcdbLT | 2 |
Less than
|
| mcdbGT | 4 |
Greater than
|
| mcdbGTE | 5 |
Greater than or Equal
|
| mcdbLTE | 3 |
Less than or Equal
|
| mcdbNEQ | 6 |
Not Equal
|
| mcdbIgnoreWildCards | 16 |
Wildcards in strings (* and ?) are interpreted as literals
|
| mcdbIgnoreCase | 32 |
Case of characters in strings is ignored
|
| mcdbIgnoreDiacritics | 64 |
Diacritics on characters in strings is ignored
|
| mcdbIgnoreWhiteSpace | 128 |
White space in strings is ignored
|
| mcdbIgnoreSymbols | 512 |
Symbols in strings are ignored
|
| mcdbMatchSubstring | 1024 |
The query string matches if it is a substring of the target property/attribute
|
| mcdbNoAttribute | 2048 |
The Named Attribute does not exist, only valid when using Empty wildcard
|
Remarks
Setting a category specification implies the query pertains only to McDBNodes that have one or more McDBNode.Categories, regardless of the CompOp argument. That is, calling SetCategory("MyCategory", mcdbNEQ) will return a set of McDBNode instances that have a Category that is not named “MyCategory”. However the result set will NOT include McDBNode instances that do not have any Category associated with them.
Exceptions
|
SetCategory Method
