DbServer.SetSelectiveRelation Method (Typed) |  |
Set a selective relation from this server to the child server; standard database operations are restricted to those records that match the relation.
Namespace: XSharp.VO.SDK
Assembly: XSharp.VORDDClasses (in XSharp.VORDDClasses.dll) Version: 2.19
SyntaxVIRTUAL METHOD SetSelectiveRelation( oDBChild AS DbServer, uRelation AS USUAL, cRelation AS STRING ) AS LOGIC
Parameters
- oDBChild
- Type: DbServer
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: String
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.
Return Value
Type: LogicTRUE if successful; otherwise, FALSE.
Remarks
Sends a NotifyRecordChange message to the child server, if successful.
As always, the expression should match or be a partial index of the controlling index of the child's work area.
As always, the expression should match or be a partial index of the controlling index of the child's work area.
Examples
The API can take these forms:
X#
1oDBCustomer:SetSelectiveRelation(oDBOrders, {||_FIELD->CustNo},"CustNo") 2oDBCustomer:SetSelectiveRelation(oDBOrders, #CustNo) 3oDBCustomer:SetSelectiveRelation(oDBOrders, {#LastName,#Initial,#FirstName})
See Also