Add Method (Category)
- Last UpdatedNov 06, 2025
- 2 minute read
The Add() method adds a new category record to the Category table.
'Declaration
Public Shared Sub Add( _
ByVal sessionId As Integer, _
ByVal categoryName As String, _
ByVal categoryDesc As DBString, _
ByVal spare1 As DBString, _
ByVal spare2 As DBString, _
ByVal spare3 As DBString, _
ByVal spare4 As DBString, _
ByVal lastEditComment As DBString, _
ByRef lastEditAt As Date, _
ByRef categoryId As Integer _
)
'Usage
Dim sessionId As Integer
Dim categoryName As String
Dim categoryDesc As DBString
Dim spare1 As DBString
Dim spare2 As DBString
Dim spare3 As DBString
Dim spare4 As DBString
Dim lastEditComment As DBString
Dim lastEditAt As Date
Dim categoryId As Integer
Category.Add(sessionId, categoryName, categoryDesc, spare1, spare2, spare3, spare4, lastEditComment, lastEditAt, categoryId)
public static void Add(
int sessionId,
string categoryName,
DBString categoryDesc,
DBString spare1,
DBString spare2,
DBString spare3,
DBString spare4,
DBString lastEditComment,
out DateTime lastEditAt,
out int categoryId
)
Parameters
- sessionId
- Required. Holds the session ID and thus the user who is making this method call.
- categoryName
- Required. Holds the name of the category.
- categoryDesc
- Optional. Holds the description of the category.
- spare1
- Optional. Holds the contents of the user-defined spare1 field.
- spare2
- Optional. Holds the contents of the user-defined spare2 field.
- spare3
- Optional. Holds the contents of the user-defined spare3 field.
- spare4
- Optional. Holds the contents of the user-defined spare4 field.
- lastEditComment
- Optional. Holds comments that describe why this record is being added.
- lastEditAt
- Output. Holds the returned datetime when this record was added. The lastEditAt parameter is used by other methods that modify or delete this type of record for optimistic concurrency control.
- categoryId
- Output. Holds the ID of the category
Observe the following input parameter rules:
- Required non-DB* parameters: Must pass a value. Cannot be empty or null.
- Optional non-DB* parameters: Either enter a value or pass a null. If passing a null and a default value has been defined, the default value will be used for the parameter.
- Required DB* parameters: Must pass a value. To enter an empty value for the parameter, pass DB*.null (e.g., DBInt.null).
- Optional DB* parameters: To enter no value for the parameter, pass DB*.null (e.g., DBInt.null). To use the default value for the parameter if one has been defined for the object being added, pass a null.