Click or drag to resize

DbServer.SetRelation Method

Set a relation from this server to the child server.

Namespace:  VO
Assembly:  VORDDClasses (in VORDDClasses.dll) Version: 2.5
Syntax
 VIRTUAL METHOD SetRelation(
	oDBChild AS USUAL,
	uRelation AS USUAL,
	cRelation AS USUAL,
	lSelective AS USUAL
) AS USUAL

Parameters

oDBChild
Type: Usual
The server attached to the child server must be specified as a DBServer object (not as an alias).  If <oDBChild> is omitted, all relations for this server are removed (the recommended way of doing this is the ClearRelations() method).
uRelation
Type: Usual
The relation code block for the server or the name or symbol representing the field from this server; a code block is constructed and macro-compiled
cRelation
Type: Usual
When the relation is specified as a code block, a string version of the code block can be provided as well; it is returned by the Relation() method.
lSelective
Type: Usual
Should this be a selective relation ?

Return Value

Type: Usual
TRUE if successful; otherwise, FALSE.
Remarks
Sends a NotifyRecordChange message to the child server, if successful. As always, the child work area should have a controlling index that matches the expression.
Examples
The API can take these forms:
X#
1oDBCustomer:SetRelation(oDBOrders, {||_FIELD->CustNo},"CustNo")
2oDBCustomer:SetRelation(oDBOrders, #CustNo)
3oDBCustomer:SetRelation(oDBOrders, {#LastName, #Initial, #FirstName})
See Also