Available output settings

The following settings are available for the LLBLGen Pro Runtime Framework. There are two sections, one for the global defaults, which you can edit in the Project Settings Editor of the designer (in the Conventions: LLBLGen Pro Runtime Framework node), and one which discusses the settings available per element, and which default setting sets their default value. This way you can easily track which default to set for which element setting.

Additionally the default attribute definitions per element is given.

Defaults

The following default settings and attributes are available, which control the default value for settings available per element.

Settings

These settings are edited using the Project Properties Editor, Output Setting Values tab.

• EntityBaseClassNameDefault. This setting specifies the default value for the EntityBaseClassName setting of an entity. When using a non-POCO/non-IPOCO preset, be sure the class specified derives (in)directly from the generated CommonEntityBase class.
  Default value: CommonEntityBase
• FieldPropertyIsPublicDefault. This setting specifies the default value for the FieldPropertyIsPublic setting of an entity field.
  Default value: true
• GenerateAsNullableTypeDefault. This setting specifies the default value for the GenerateAsNullableType setting of a new entity field.
  Default value: true
• NavigatorPropertyIsPublicDefault. This setting specifies the default value for the NavigatorPropertyIsPublic setting of an entity field.
  Default value: true

Default attribute definitions

The following attribute definitions are defined by default for the LLBLGen Pro Runtime Framework. These attribute definitions are edited using the Project Settings Editor, Attributes node.

• Browsable($false). Defined for element types: Navigator returning single value.

Element Settings

The following settings are available per element. These settings are edited on the element's own editor (or the containing element's editor, in the case where the element itself doesn't have a separate editor) on the Code-gen info tab, or on the Project Settings Editor, if the element is the project.

Entity definition settings

• EntityBaseClassName. The name of the base class for the generated entity class. The following macros are available: {$Name} for the entity name without group name, {$GroupName} for the name of the group the entity is in, {$FullName} for the group name plus entity name. Sub-types will always inherit from their super-type and not from the class specified. The specified class has to inherited (in)directly from the runtime framework's base class for entities: EntityBase (Self-servicing) or EntityBase2 (Adapter)
  Default value: the value of the default EntityBaseClassNameDefault.

Field settings (value type definition field, entity definition field)

• GenerateAsNullableType. When set to true, the field's type will be generated as a Nullable<T> / Nullable(Of T), if the field's type is a value type and the field is nullable
  Default value: the value of the default GenerateAsNullableTypeDefault.
• FieldPropertyIsPublic. When set to true (default), the property of an entity field is generated as public. When set to false, the property is generated as internal (friend in VB.NET)
  Default value: the value of the default FieldPropertyIsPublicDefault.

Navigator settings

• NavigatorPropertyIsPublic. When set to true (default), the property of a navigator is generated as public. When set to false, the property is generated as internal (friend in VB.NET)
  Default value: the value of the default NavigatorPropertyIsPublicDefault.

Project settings

• AdapterDbGenericProjectFileSuffix. This value is the suffix appended to the VS.NET project filename for the database generic generated code
  Default value: empty string
• AdapterDbGenericSubFolderName. This value is the name for the subfolder in the destination folder in which the generated database generic files are placed.
  Default value: DatabaseGeneric
• AdapterDbSpecificNamespaceSuffix. This value is the suffix appended to the root namespace for the database specific generated code. Do not prefix this name with a '.', as that's added automatically by the code generator.
  Default value: DatabaseSpecific
• AdapterDbSpecificProjectFileSuffix. This value is the suffix appended to the VS.NET project filename for the database specific generated code.
  Default value: DbSpecific
• AdapterDbSpecificSubFolderName. This value is the name for the subfolder in the destination folder in which the generated database specific files are placed.
  Default value: DatabaseSpecific
• ConvertNulledReferenceTypesToDefaultValue. When set to false, an entity field in the LLBLGen Pro Runtime Framework which has a reference type (e.g. string) will return null / Nothing if the value for the field is null / Nothing. When set to true, the default value belonging to that reference type is returned. The default value for a type is produced by the generated class TypeDefaultValue.
  Default value: true
• LazyLoadingWithoutResultReturnsNew. When set to true, lazy loading functionality for the LLBLGen Pro Runtime Framework which fetches a m:1 or 1:1 related entity will return a new entity when the related entity to fetch is not found. When set to false, it will return null (Nothing). SelfServicing specific.
  Default value: false
• TdlEmitTimeDateInOutputFiles. When set to true, the TDL code emitter will emit the time and date for the &lt;[Time]&gt; statement for the LLBLGen Pro Runtime Framework, otherwise nothing will be emitted for that statement. Set to false if you need files to stay the same if they're not effectively changed, for example for source control systems.
  Default value: true.