Back to Devexpress

XafApplication Members

expressappframework-devexpress-dot-expressapp-dot-xafapplication-dot-underscore-members.md

latest48.1 KB
Original Source

XafApplication Members

Manages an XAF application.

Constructors

NameDescription
XafApplication()Creates an instance of the XafApplication class.
XafApplication(ITypesInfo)Creates an instance of the XafApplication class and initializes the XafApplication.TypesInfo property to a specified value.

Fields

NameDescription
ConfirmationsGets the name on the Localization node’s child node that provides access to the localizable confirmations texts.
CurrentVersionFor internal use only.
ModelCacheLocationKeyThe name of the configuration file key, which specifies the Application Model cache file location (see XafApplication.EnableModelCache).
OptionsNodeNameFor internal use only.
TablePrefixesKeyFor internal use.
TraceLogLocationKeySpecifies the setting in the configuration file’s appSettings section. This setting specifies the log file location.
XafApplicationLogonCatchExceptionKeySpecifies a string identifier for exceptions occurred while logging on to the application.

Properties

NameDescription
ApplicationNameSpecifies the application’s name.
CanRaiseEvents protectedGets a value indicating whether the component can raise an event. Inherited from Component.
CheckCompatibilityTypeSpecifies how database and application compatibility is checked.
ConnectionSpecifies the connection to the database used by the application.
ConnectionStringSpecifies the connection string used to connect to the application’s database or to the Application Server.
ContainerGets the IContainer that contains the Component. Inherited from Component.
CurrentAspectProviderReturns an ICurrentAspectProvider object that supplies culture-specific information.
DatabaseUpdateModeSpecifies the database update mode.
DefaultCollectionSourceModeSpecifies the default mode of operation for Collection Sources created by the XafApplication.
DelayedViewItemsInitializationIndicates whether View Items controls are initialized immediately when a View is created.
DesignMode protectedGets a value that indicates whether the Component is currently in design mode. Inherited from Component.
EditorFactoryProvides access to the application’s Editors Factory, which is used to load View Items and List Editors to the Application Model and create them when needed.
EnableModelCacheSpecifies if the Application Model cache designed to improve the startup speed and performance is enabled.
Events protectedGets the list of event handlers that are attached to this Component. Inherited from Component.
IsLoadingIndicates whether the application component is currently being initialized.
LinkNewObjectToParentImmediatelySpecifies whether or not a link between a master and child object is created immediately when the NewObjectViewController.NewObjectAction is executed in a nested List View with a non-aggregated collection.
MainWindowProvides access to the application’s main Window.
MaxLogonAttemptCountSpecifies the allowed number of failed login attempts before the application closes.
ModelProvides access to the Application Model‘s root node.
ModulesProvides access to the module list used by the application.
ObjectSpaceProviderProvides access to the application’s Object Space Provider.
ObjectSpaceProviderContainer
ObjectSpaceProvidersGets a list of Object Space Providers used by XafApplication.
OptimizedControllersCreationDisables the instantiation of Controllers that will never be activated in nested List Views.
ResourcesExportedToModelProvides access to a collection of Resource Localizers used in the current application to extend the Application Model’s IModelLocalization node.
SecurityProvides access to the Security Strategy used in the application.
ServiceProviderProvides access to IServiceProvider.
ShowViewStrategySpecifies the application’s Show View Strategy.
SiteFor internal use only.
TitleSpecifies the application’s title.
TypesInfoGets the ITypesInfo object that supplies metadata on types used in an XAF application.

Methods

NameDescription
AskConfirmation(ConfirmationType)Requests an end-user confirmation.
BeginInit()Starts the XafApplication‘s initialization. Initialization occurs at runtime.
CheckCompatibility()Checks whether the application and database are compatible, and if not, tries to make them compatible.
CollapseModel()
CreateCollectionSource(IObjectSpace, Type, String, CollectionSourceDataAccessMode, CollectionSourceMode)Creates a Collection Source for a specific List View.
CreateCollectionSource(IObjectSpace, Type, String, CollectionSourceMode)Creates a Collection Source for a specific List View.
CreateCollectionSource(IObjectSpace, Type, String, Boolean, CollectionSourceMode)Creates a Collection Source for a specific List View.
CreateCollectionSource(IObjectSpace, Type, String)Creates a collection source for a specified List View.
CreateController<ControllerType>()Creates a Controller of a specified type. If there is a Controller of the same type, assigns its settings to the new Controller.
CreateDashboardView(IObjectSpace, String, Boolean)Creates a Dashboard View using information from the Application Model‘s Views
CreateDatabaseUpdater(IObjectSpaceProvider)Creates a Database Updater for a specified Object Space Provider.
CreateDetailView(IObjectSpace, IModelDetailView, Boolean, Object)Creates a Detail View for the specified object with settings from the Application Model‘s Views
CreateDetailView(IObjectSpace, IModelDetailView, Boolean)Creates a Detail View based on information from the Application Model‘s Views
CreateDetailView(IObjectSpace, Object, View)Creates a Detail View for a specified object based on information on the source View.
CreateDetailView(IObjectSpace, Object, Boolean)Creates a DetailView for the specified object and initializes its properties.
CreateDetailView(IObjectSpace, Object)Creates a Detail View based on information specified in the Application Model for the type of the specified object.
CreateDetailView(IObjectSpace, String, Boolean, Object)Creates a Detail View for the specified object based on the information from the Application Model‘s Views
CreateDetailView(IObjectSpace, String, Boolean)Creates a Detail View based on information from the Application Model‘s Views
CreateDetailViewWithAsyncObjectLoad(IObjectSpace, Object, Object)
CreateDetailViewWithAsyncObjectLoad(IObjectSpace, String, Object, Object)
CreateFrame(TemplateContext)Creates a new Frame.
CreateLayoutManager(Boolean)Creates a Layout Manager.
CreateListEditor(CollectionSourceBase, IModelListView)Creates the List Editor which is specified in the appropriate Application Model node.
CreateListView(IObjectSpace, Type, Boolean)Creates a List View used for the objects of the specified type, by default.
CreateListView(IModelListView, CollectionSourceBase, Boolean, ListEditor)For internal use.
CreateListView(IModelListView, CollectionSourceBase, Boolean)Creates a List View based on the information from the Application Model‘s node specified by the modelListView parameter.
CreateListView(String, CollectionSourceBase, Boolean)Creates a List View based on information from the Application Model‘s Views
CreateListView(Type, Boolean)Creates a List View used for the objects of the specified type, by default.
CreateNestedFrame(ViewItem, TemplateContext, View)
CreateNestedFrame(ViewItem, TemplateContext)
CreateNestedObjectSpace(IObjectSpace)Creates nested Object Space.
CreateObject<T>(out IObjectSpace)Creates an object of the type designated by the generic type parameter.
CreateObjectSpace()Creates an Object Space. Use this method overload if your application registers only one ObjectSpaceProvider.
CreateObjectSpace(Type, String)Creates an object space for the specified business object type in a multi-tenant application.
CreateObjectSpace(Type)Creates an Object Space that supports a specific object type. Use this method overload if your application registers several ObjectSpaceProviders.
CreateObjectSpace<T>()Creates an Object Space of the specified type.
CreateObjectSpace<T>(String)Creates an object space for the specified business object type in a multi-tenant application.
CreatePopupWindow(TemplateContext, String, Controller[])Creates a new pop-up Window.
CreatePopupWindow(TemplateContext, String, View, Boolean, Controller[])
CreatePopupWindow(TemplateContext, String, Boolean, Controller[])Creates a new pop-up Window.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String, CollectionSourceDataAccessMode, CollectionSourceMode)Creates a Collection Source for a nested List View that displays a collection property.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String, CollectionSourceMode)Creates a Collection Source for a nested List View that displays a collection property.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String, Boolean, CollectionSourceMode)Creates a Collection Source for a nested List View that displays a collection property.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String)Creates a Collection Source for a nested List View that displays a collection property.
CreateTemplate(String)For internal use only.
CreateWindow(TemplateContext, ICollection<Controller>, Boolean, Boolean, View, ViewShortcut)
CreateWindow(TemplateContext, ICollection<Controller>, Boolean, Boolean)Creates a new Window.
CreateWindow(TemplateContext, ICollection<Controller>, Boolean)Creates a new Window.
Dispose()Releases all resources used by the Component. Inherited from Component.
DisposeAsync()
EndInit()Ends the XafApplication‘s initialization.
Equals(Object, Object) staticDetermines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object)Determines whether the specified object is equal to the current object. Inherited from Object.
Exit()Finishes runing the application.
FindDetailViewId(Object, View)Returns the ID of the Detail View which must be used for a specific object, when invoked from the source View.
FindDetailViewId(Type)Returns the ID of the Detail View which is used for objects of a specified type by default.
FindListViewId(Type)Returns the ID of the List View which is used for objects of a specified type by default.
FindLookupListViewId(Type)Returnes the ID of the Lookup List View which is used for objects of a specified type by default.
FindModelClass(Type)Returns the Application Model‘s IModelClass node representing the specific business class.
FindModelView(String)Provides access the Application Model node that defines a specified View.
GetCompletedViewShortcut(ViewShortcut)For internal use only.
GetDetailViewId(Type)Returns the ID of the Detail View which is used for objects of a specified type by default, and raises an exception if the appropriate View ID is not found.
GetDiffDefaultName(String)Gets the model differences file name
GetHashCode()Serves as the default hash function. Inherited from Object.
GetLifetimeService()Retrieves the current lifetime service object that controls the lifetime policy for this instance. Inherited from MarshalByRefObject.
GetListViewId(Type)Returns the ID of the List View which is used for objects of a specified type by default, and raises the ‘CannotFindListViewWithId’ exception if the appropriate View ID is not found.
GetObjectSpaceToShowDetailViewFrom(Frame, Type, TargetWindow)Returns an Object Space in which a Detail View should be created.
GetService(Type) protectedReturns an object that represents a service provided by the Component or by its Container. Inherited from Component.
GetTemplateCustomizationModel(IFrameTemplate)Returns the Application Model node where settings of a specified Template are stored.
GetType()Gets the Type of the current instance. Inherited from Object.
InitializeLifetimeService()Obtains a lifetime service object to control the lifetime policy for this instance. Inherited from MarshalByRefObject.
LogOff()Performs the application logout.
Logon()Performs the logon.
MemberwiseClone() protectedCreates a shallow copy of the current Object. Inherited from Object.
MemberwiseClone(Boolean) protectedCreates a shallow copy of the current MarshalByRefObject object. Inherited from MarshalByRefObject.
ProcessShortcut(ViewShortcut)Creates a View by a specified shortcut.
ReferenceEquals(Object, Object) staticDetermines whether the specified Object instances are the same instance. Inherited from Object.
SaveModelChanges()Saves the changes made by an end-user, up to the current moment, to the differences storage.
SetFormattingCulture(String)Sets the specified formatting culture for the XAF WinForms application. To localize and change formatting culture for the XAF ASP.NET Core Blazor applications, refer to the following topics: Localize an XAF Application and IXafCultureInfoService.
SetLanguage(String)Sets the specified language for the current application when called before the application windows are shown.
Setup()Initializes the newly created XafApplication class instance.
Setup(ExpressApplicationSetupParameters)Initializes the newly created XafApplication class instance.
Setup(String, IObjectSpaceProvider, ApplicationModulesManager, ISecurityStrategyBase)Initializes the newly created XafApplication class instance.
Setup(String, IObjectSpaceProvider, String[], ISecurityStrategyBase)Initializes the newly created XafApplication class instance.
Setup(String, IObjectSpaceProvider)Initializes the newly created XafApplication class instance.
Setup(String, IList<IObjectSpaceProvider>, ApplicationModulesManager, ISecurityStrategyBase)Initializes the newly created XafApplication class instance.
Setup(String, IList<IObjectSpaceProvider>, String[], ISecurityStrategyBase)Initializes the newly created XafApplication class instance.
Setup(String, String, String[], ISecurityStrategyBase)Initializes the newly created XafApplication class instance.
Setup(String, String, String[])Initializes the newly created XafApplication class instance.
ToString()Returns a String containing the name of the Component, if any. This method should not be overridden. Inherited from Component.
UpdateStatus(String, String, String, Object[])Triggers the XafApplication.StatusUpdating event.

Events

NameDescription
CreateCustomCollectionSourceOccurs when creating a Collection Source for a List View.
CreateCustomDeviceSpecificModelDifferenceStoreOccurs when a storage for device-specific model differences is being created.
CreateCustomLogonAction
CreateCustomLogonParameterStoreOccurs both when reading and writing the last logon parameters, before creating the logon parameters storage.
CreateCustomLogonWindowControllersOccurs when creating Controllers for a Logon Window.
CreateCustomLogonWindowObjectSpaceOccurs when creating an Object Space for a Logon Window’s Detail View.
CreateCustomModelCacheManagerOccurs when the object used to manage saving and loading the Application Model cache is created.
CreateCustomModelCacheStreamThis event is intended for internal use. Handle the XafApplication.CreateCustomModelCacheManager event instead.
CreateCustomModelDifferenceStoreOccurs when a storage for model differences is being created.
CreateCustomObjectSpaceProviderOccurs when setting up the application.
CreateCustomPropertyCollectionSourceOccurs when creating a Collection Source for a nested List View that displays a collection property.
CreateCustomTemplateOccurs when creating a Template.
CreateCustomUserModelDifferenceStoreOccurs when a storage for end-user model differences is being created.
CustomCheckCompatibilityOccurs when the application accesses the database.
CustomizeFormattingCultureOccurs after a formatting culture has been set internally.
CustomizeLanguageOccurs after a language has been set for the application internally.
CustomizeLanguagesListOccurs when setting up the application.
CustomizeTemplateOccurs after a Template has been created.
CustomProcessShortcutOccurs when a View is created by its shortcut.
DashboardViewCreatedOccurs after a Dashboard View has been created.
DashboardViewCreatingOccurs when creating a Dashboard View.
DatabaseUpdaterCreatingOccurs when creating a database updater.
DatabaseVersionMismatchOccurs when the database should be synchronized with the application version.
DetailViewCreatedOccurs after a Detail View has been created.
DetailViewCreatingOccurs when creating a Detail View.
DisposedOccurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
FrameCreated
HandleShortcutProcessingExceptionFor internal use only.
LastLogonParametersReadOccurs after loading the last logon parameters from the settings storage to the logon object.
LastLogonParametersReadingOccurs before loading the last logon parameters from the settings storage to the logon object.
LastLogonParametersWritingOccurs before saving the logon Window‘s logon parameters to the settings storage.
ListViewCreatedOccurs after a List View is created.
ListViewCreatingOccurs when creating a List View.
LoggedOffOccurs after an end-user has logged off.
LoggedOnOccurs after an end-user has logged on.
LoggingOffOccurs when a user clicks the Log Off button.
LoggingOnOccurs when the Logon button on the logon Window is clicked.
LogonFailedOccurs when the logon fails.
ModelChangedOccurs when the Application Model instance returned by the XafApplication.Model property is changed.
ObjectSpaceCreatedOccurs after an Object Space has been created via the XafApplication.CreateObjectSpace method.
PropertyChangedOccurs when the XafApplication.ApplicationName, XafApplication.Security or XafApplication.Connection property is changed.
SettingUpOccurs before initializing the XafApplication class instance.
SetupCompleteOccurs after the XafApplication class instance has been initialized.
ShowViewStrategyChangedOccurs when the XafApplication.ShowViewStrategy object is changed.
StatusUpdatingOccurs when the XafApplication status is updated.
UserDifferencesLoadedOccurs after the user-defined Application Model differences are loaded.
ViewCreatedOccurs after a View has been created.
ViewCreatingOccurs when creating a View.
ViewShowingOccurs before showing a View.
ViewShownOccurs after a View is shown.

See Also

XafApplication Class

DevExpress.ExpressApp Namespace