DBTable.CreateNewField Method (DBDriverBase, String, Type, Int32, Int32, Int32, Boolean, Boolean, Int32, LogNode) |
Creates a new field based on the elements specified. It assumes there are no fields with the name specified already in this target. The field
is added at the end of the fields list.
Namespace:
SD.LLBLGen.Pro.DBDriverCore
Assembly:
SD.LLBLGen.Pro.DBDriverCore (in SD.LLBLGen.Pro.DBDriverCore.dll) Version: 5.3.0.0 (5.3.0)
Syntaxpublic DBTableField CreateNewField(
DBDriverBase driverToUse,
string fieldName,
Type netType,
int length,
int precision,
int scale,
bool isNullable,
bool isPk,
int preferredDbType,
out LogNode resultNode
)
Public Function CreateNewField (
driverToUse As DBDriverBase,
fieldName As String,
netType As Type,
length As Integer,
precision As Integer,
scale As Integer,
isNullable As Boolean,
isPk As Boolean,
preferredDbType As Integer,
<OutAttribute> ByRef resultNode As LogNode
) As DBTableField
Parameters
- driverToUse
- Type: SD.LLBLGen.Pro.DBDriverCore.DBDriverBase
The driver to use. - fieldName
- Type: System.String
Name of the field. - netType
- Type: System.Type
the .NET type to use for choosing the db type, if preferred db type isn't specified. - length
- Type: System.Int32
The length. - precision
- Type: System.Int32
The precision. - scale
- Type: System.Int32
The scale. - isNullable
- Type: System.Boolean
True if the field is nullable - isPk
- Type: System.Boolean
true if the field is part of the PK - preferredDbType
- Type: System.Int32
Preferred db type according to the used type shortcut. If -1, the default database type is used, using the usual filtering.
If value of 0 or higher, the dbtype is used, overruling all other types. - resultNode
- Type: SD.LLBLGen.Pro.Core.GeneralDataStructures.LogNode
The result node. Is null if everything went OK, not null if error was found. Mainly used to get detailed error messaging
to the user why an automap failed.
Return Value
Type:
DBTableField
The created new field or null if no field could be created.
Remarks
If there's no compatible type definition found, it will not create any field. Used for auto-generating table fields from mappings. Do not use
this routine from a driver to store meta-data, use the DBTableField ctor for that, as this routine will set the CreatedByDesigner flag on the created field.
See Also