SetName Method

Description

Assigns the Name property of McDBNode instances returned by this McDBQuery.

Return Type

None

Syntax

object.SetName Name, [CompOp]

The SetName Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDBQuery.
Name	Required. A String value. The (string) McDBNode:IQL~McDBNode.Name McDBNode.Name McDBNode.Name to place in the query by example specification.
CompOp	Optional. A mcDBCompOp enumeration, as described in settings. How result McDBNode instances will compare to Name.

Settings

The settings for CompOp are:

Constant		Value	Description
	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

This method always uses the native McDBNode.Name for comparison purposes. Therefore, it is not possible to find McDBNode instances with a particular alias name using this method.

Exceptions

Error Value Description

E_PENDING &H8000000A The database context has not been established. Call AttachDatabase().