SQLTable.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.VOSQLClasses (in XSharp.VOSQLClasses.dll) Version: 2.21
Syntax VIRTUAL METHOD SetSelectiveRelation(
oChild,
uRelation,
cRelation
) AS USUAL CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public virtual Usual SetSelectiveRelation(
Usual oChild = default,
Usual uRelation = default,
Usual cRelation = default
)
Request Example
View SourceParameters
- oChild (Optional)
- Type: Usual
The server attached to the child server must be specified as a SQLTable object. If oSQLChild is omitted, all relations for this server are removed (the recommended way of doing this is the ClearRelations() method).
- uRelation (Optional)
- Type: Usual
The field name from this server. An alias can be used for the field name. (See the SQLSelect:FieldInfo() method to set an alias name). - cRelation (Optional)
- Type: Usual
The array of field names representing the relation for the server. The array can also contain complex relational operators (SQL_RELOP_AND, SQL_RELOP_OR, SQL_RELOP_NOT, SQL_RELOP_OPENP, SQL_RELOP_CLOSEP).
Return Value
Type:
Usual
TRUE if successful; otherwise, FALSE.
Remarks
Sends a NotifyRecordChange message to the child server, if successful. This method is equivalent to the SetRelation() method.
Examples
The API can take these forms:
1oSQLCustomer:SetSelectiveRelation(oSQLOrders,;
2{||_FIELD->CustNo},"CustNo")
3oSQLCustomer:SetSelectiveRelation(oSQLOrders, CustNo)
4oSQLCustomer:SetSelectiveRelation(oSQLOrders,;
5{#LastName,#Initial,#FirstName})
See Also