brName property

Depending upon the object, returns various information as described below:

clsD3Connection object - returns the parameters used by the brOpenConnection method to establish a connection.
clsD3DynamicArray object - for objects created from the methods of the clsD3Connection, clsD3TCLCommand or clsD3File classes, this property returns information about the parent object, otherwise NULL is returned.
clsD3Environment object - returns the library-specific string name, specifically, "D3 Class Library (ODBC Only)".
clsD3File object - returns the name of the D3 file associated with the object.
clsD3Index object - returns the index correlative associated with the object.
clsD3RuleModule object - returns the name of the rule module associated with the object.
clsD3SelectList object - returns the name of the list if opened with a named parameter.
clsD3TCLCommand object - returns the TCL command associated with the object (same as brCommand).

Syntax

sValue = object.brName

Parameters

Parameter	Description
`sValue`	The return value is a String data type.
`object`	An object variable that represents an object in the Applies To list.

Remarks

clsD3Connection objects – This property returns the first parameter of the brOpenConnection method - either "ODBC" or "ODBC;" (same as the brDomain property) and the ODBC data source name passed as the second parameter to the brOpenConnection method (same as the brDatabase property) separated by a space.

clsD3DynamicArray objects – For clsD3DynamicArray objects created from the methods of the clsD3File class, namely, brRead, brReadU, brReadV and brReadVU, this property returns the item-id of the D3 item read from the file. For clsD3DynamicArray objects created from the brCapturing and brReturning methods, this property returns the statement that was executed.

The brName property will return NULL if the object has not been initialized or opened.

Example

Private Sub TestList_Click()
   Dim oList As clsD3SelectList
 
   OpenConnection ' Subroutine to establish connection
 
   Set oList = oConn.brOpenSelectList("select products")
   oList.brReadnext
   MsgBox "This list was produced by the command " & oList.brName
   MsgBox "The item-id of the first element is " & oList.brItemId
 
   oConn.brCloseSelectList oList
   CloseConnection ' Subroutine to close connection
End Sub

Applies to

clsD3Connection class, clsD3Database class, clsD3DynamicArray class, clsD3Environment class, clsD3File class, clsD3Index class, clsD3NetDomain class, clsD3RuleCatalog class, clsD3RuleModule class, clsD3SelectList class, clsD3TCLCommand class, clsD3VirtualMachine class