Session.AutoCreateOption Property
Gets or sets the action which is performed when the session is connected to a data store.
Namespace: DevExpress.Xpo
Assembly: DevExpress.Xpo.v24.1.dll
NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.TreeMap, DevExpress.Xpo
NuGet Package: DevExpress.Xpo
Declaration
Property Value
| Type | Default | Description |
|---|---|---|
| AutoCreateOption | DatabaseAndSchema | An AutoCreateOption enumeration value which specifies the action which is performed when the session is connected to a data store. |
Available values:
| Name | Description |
|---|---|
| DatabaseAndSchema | A session will try to automatically create the database if it doesn’t exist. It will also create or update the database schema for any persistent classes currently being used. |
| SchemaOnly | A session will automatically create or update the database schema for the persistent classes currently being used. If the database doesn’t exist, it won’t be created by a session. |
| None | A session will not automatically create the database or update the database schema. The database schema is still queried and checked to match the currently used persistent class metadata. |
| SchemaAlreadyExists | A session will never query the database for schema to validate against persistent class metadata. This will suppress the SchemaCorrectionNeededException, but a database error may occur during data operations if the schema is not compatible with run-time persistent classes metadata. |
Remarks
To connect a session to a database use the Session.Connect method. The AutoCreateOption property specifies the action which is performed when the session is connected to a data store. For a list of available actions, see the AutoCreateOption topic.
If the AutoCreateOption property is set to the AutoCreateOption.None value, the SchemaCorrectionNeededException is raised every time the database metadata is mismatched.