Back to Devexpress

WinApplication Members

expressappframework-devexpress-dot-expressapp-dot-win-dot-winapplication-dot-underscore-members.md

latest69.7 KB
Original Source

WinApplication Members

Manages a WinForms XAF application.

Constructors

NameDescription
WinApplication()Initializes a new instance of the WinApplication class.

Fields

NameDescription
ApplicationUpdateCompleteName
Confirmations staticGets the name on the Localization node’s child node that provides access to the localizable confirmations texts. Inherited from XafApplication.
CurrentVersion staticFor internal use only. Inherited from XafApplication.
IgnoreUserModelDiffsArgNameA string specifying the command line argument which prohibits saving the user differences. When this argument is passed, the WinApplication.IgnoreUserModelDiffs property is set to true.
ModelCacheLocationKey staticThe name of the configuration file key, which specifies the Application Model cache file location (see XafApplication.EnableModelCache). Inherited from XafApplication.
ModelDiffsPathArgNameA string, which is the command line argument prefix, specifying the model differences directory path. When the argument with this prefix is passed, the remaining part of the argument is set to the WinApplication.ModelDifferenceFilePath property.
NewVersionServerAppSettingsNameContains the name of the configuration file key, specifying the path to the folder with a new application version.
OptionsNodeName staticFor internal use only. Inherited from XafApplication.
TablePrefixesKey staticFor internal use. Inherited from XafApplication.
TraceLogLocationKey staticSpecifies the setting in the configuration file’s appSettings section. This setting specifies the log file location. Inherited from XafApplication.
UserDiffsModelLocationKeyThe name of the configuration file key, which specifies the user differences file location.
XafApplicationLogonCatchExceptionKey staticSpecifies a string identifier for exceptions occurred while logging on to the application. Inherited from XafApplication.

Properties

NameDescription
ApplicationNameSpecifies the application’s name. Inherited from XafApplication.
CanRaiseEvents protectedGets a value indicating whether the component can raise an event. Inherited from Component.
CheckCompatibilityTypeSpecifies how database and application compatibility is checked. Inherited from XafApplication.
ConnectionSpecifies the connection to the database used by the application. Inherited from XafApplication.
ConnectionStringSpecifies the connection string used to connect to the application’s database or to the Application Server. Inherited from XafApplication.
ContainerGets the IContainer that contains the Component. Inherited from Component.
CurrentAspectProviderReturns an ICurrentAspectProvider object that supplies culture-specific information. Inherited from XafApplication.
DatabaseUpdateModeSpecifies the database update mode. Inherited from XafApplication.
DefaultCollectionSourceModeSpecifies the default mode of operation for Collection Sources created by the XafApplication. Inherited from XafApplication.
DelayedViewItemsInitializationIndicates whether View Items controls are initialized immediately when a View is created. Inherited from XafApplication.
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. Inherited from XafApplication.
EnableModelCacheSpecifies if the Application Model cache designed to improve the startup speed and performance is enabled. Inherited from XafApplication.
Events protectedGets the list of event handlers that are attached to this Component. Inherited from Component.
FrameTemplateFactorySpecifies the IFrameTemplateFactory object that provides Templates for a Windows Forms application.
IgnoreUserModelDiffsSpecifies if the user model differences are ignored.
IsLoadingIndicates whether the application component is currently being initialized. Inherited from XafApplication.
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. Inherited from XafApplication.
MainWindowGets the application’s main Window.
MaxLogonAttemptCountSpecifies the allowed number of failed login attempts before the application closes. Inherited from XafApplication.
Messaging staticSpecifies the Messaging object, used by the Windows Forms application to display message boxes.
ModelProvides access to the Application Model‘s root node. Inherited from XafApplication.
ModelDifferenceFilePathSpecifies a path to the directory where the model differences file (Model.xafml) reside.
ModulesProvides access to the module list used by the application. Inherited from XafApplication.
ObjectSpaceProviderProvides access to the application’s Object Space Provider. Inherited from XafApplication.
ObjectSpaceProviderContainerInherited from XafApplication.
ObjectSpaceProvidersGets a list of Object Space Providers used by XafApplication. Inherited from XafApplication.
OptimizedControllersCreationDisables the instantiation of Controllers that will never be activated in nested List Views. Inherited from XafApplication.
ResourcesExportedToModelProvides access to a collection of Resource Localizers used in the current application to extend the Application Model’s IModelLocalization node. Inherited from XafApplication.
SecurityProvides access to the Security Strategy used in the application. Inherited from XafApplication.
ServiceProviderProvides access to IServiceProvider. Inherited from XafApplication.
ShowViewStrategySpecifies the Show View Strategy used in a Windows Forms application.
SiteFor internal use only. Inherited from XafApplication.
SplashScreenSpecifies the splash screen displayed when a Windows Forms application starts.
TitleSpecifies the application’s title. Inherited from XafApplication.
TypesInfoGets the ITypesInfo object that supplies metadata on types used in an XAF application. Inherited from XafApplication.
UseLightStyleEnables the Light Style in a WinForms application.
UseOldTemplatesReplaces old templates (MainForm and DetailForm) with new templates in WinForms applications (v14.2+).
UserModelDifferenceFilePathSpecifies the path to the user model differences file.

Methods

NameDescription
AskConfirmation(ConfirmationType)Requests an end-user confirmation via the dialog window.
BeginInit()Starts the XafApplication‘s initialization. Initialization occurs at runtime. Inherited from XafApplication.
CheckCompatibility()Checks whether the application and database are compatible, and if not, tries to make them compatible. Inherited from XafApplication.
CollapseModel()Inherited from XafApplication.
CreateBuilder(Action<IWinApplicationBuilderOptions>) staticCreates an application builder object that you can use to customize the application options.
CreateCollectionSource(IObjectSpace, Type, String, CollectionSourceDataAccessMode, CollectionSourceMode)Creates a Collection Source for a specific List View. Inherited from XafApplication.
CreateCollectionSource(IObjectSpace, Type, String, CollectionSourceMode)Creates a Collection Source for a specific List View. Inherited from XafApplication.
CreateCollectionSource(IObjectSpace, Type, String, Boolean, CollectionSourceMode)Creates a Collection Source for a specific List View. Inherited from XafApplication.
CreateCollectionSource(IObjectSpace, Type, String)Creates a collection source for a specified List View. Inherited from XafApplication.
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. Inherited from XafApplication.
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. Inherited from XafApplication.
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. Inherited from XafApplication.
CreateDetailView(IObjectSpace, Object, Boolean)Creates a DetailView for the specified object and initializes its properties. Inherited from XafApplication.
CreateDetailView(IObjectSpace, Object)Creates a Detail View based on information specified in the Application Model for the type of the specified object. Inherited from XafApplication.
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)Inherited from XafApplication.
CreateDetailViewWithAsyncObjectLoad(IObjectSpace, String, Object, Object)Inherited from XafApplication.
CreateFrame(TemplateContext)Creates a new Frame. Inherited from XafApplication.
CreateLayoutManager(Boolean)Creates a Layout Manager. Inherited from XafApplication.
CreateListEditor(CollectionSourceBase, IModelListView)Creates the List Editor which is specified in the appropriate Application Model node. Inherited from XafApplication.
CreateListView(IObjectSpace, Type, Boolean)Creates a List View used for the objects of the specified type, by default. Inherited from XafApplication.
CreateListView(IModelListView, CollectionSourceBase, Boolean, ListEditor)For internal use. Inherited from XafApplication.
CreateListView(IModelListView, CollectionSourceBase, Boolean)Creates a List View based on the information from the Application Model‘s node specified by the modelListView parameter. Inherited from XafApplication.
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. Inherited from XafApplication.
CreateNestedFrame(ViewItem, TemplateContext, View)Inherited from XafApplication.
CreateNestedFrame(ViewItem, TemplateContext)Inherited from XafApplication.
CreateNestedObjectSpace(IObjectSpace)Creates nested Object Space. Inherited from XafApplication.
CreateObject<T>(out IObjectSpace)Creates an object of the type designated by the generic type parameter. Inherited from XafApplication.
CreateObjectSpace()Creates an Object Space. Use this method overload if your application registers only one ObjectSpaceProvider. Inherited from XafApplication.
CreateObjectSpace(Type, String)Creates an object space for the specified business object type in a multi-tenant application. Inherited from XafApplication.
CreateObjectSpace(Type)Creates an Object Space that supports a specific object type. Use this method overload if your application registers several ObjectSpaceProviders. Inherited from XafApplication.
CreateObjectSpace<T>()Creates an Object Space of the specified type. Inherited from XafApplication.
CreateObjectSpace<T>(String)Creates an object space for the specified business object type in a multi-tenant application. Inherited from XafApplication.
CreatePopupWindow(TemplateContext, String, Controller[])Creates a new pop-up Window. Inherited from XafApplication.
CreatePopupWindow(TemplateContext, String, View, Boolean, Controller[])Inherited from XafApplication.
CreatePopupWindow(TemplateContext, String, Boolean, Controller[])Creates a new pop-up Window. Inherited from XafApplication.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String, CollectionSourceDataAccessMode, CollectionSourceMode)Creates a Collection Source for a nested List View that displays a collection property. Inherited from XafApplication.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String, CollectionSourceMode)Creates a Collection Source for a nested List View that displays a collection property. Inherited from XafApplication.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String, Boolean, CollectionSourceMode)Creates a Collection Source for a nested List View that displays a collection property. Inherited from XafApplication.
CreatePropertyCollectionSource(IObjectSpace, Type, Object, IMemberInfo, String)Creates a Collection Source for a nested List View that displays a collection property. Inherited from XafApplication.
CreateTemplate(String)For internal use only. Inherited from XafApplication.
CreateWindow(TemplateContext, ICollection<Controller>, Boolean, Boolean, View, ViewShortcut)Inherited from XafApplication.
CreateWindow(TemplateContext, ICollection<Controller>, Boolean, Boolean)Creates a new Window. Inherited from XafApplication.
CreateWindow(TemplateContext, ICollection<Controller>, Boolean)Creates a new Window. Inherited from XafApplication.
Dispose()Releases all resources used by the Component. Inherited from Component.
DisposeAsync()Inherited from XafApplication.
EditModel()Displays the Model Editor form.
EndInit()Ends the XafApplication‘s initialization. Inherited from XafApplication.
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. Inherited from XafApplication.
FindDetailViewId(Object, View)Returns the ID of the Detail View which must be used for a specific object, when invoked from the source View. Inherited from XafApplication.
FindDetailViewId(Type)Returns the ID of the Detail View which is used for objects of a specified type by default. Inherited from XafApplication.
FindListViewId(Type)Returns the ID of the List View which is used for objects of a specified type by default. Inherited from XafApplication.
FindLookupListViewId(Type)Returnes the ID of the Lookup List View which is used for objects of a specified type by default. Inherited from XafApplication.
FindModelClass(Type)Returns the Application Model‘s IModelClass node representing the specific business class. Inherited from XafApplication.
FindModelView(String)Provides access the Application Model node that defines a specified View. Inherited from XafApplication.
GetCompletedViewShortcut(ViewShortcut)For internal use only. Inherited from XafApplication.
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. Inherited from XafApplication.
GetDiffDefaultName(String)Gets the model differences file name Inherited from XafApplication.
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. Inherited from XafApplication.
GetLogonParametersFileName(String) staticReturns a name for the file where logon parameters are stored.
GetObjectSpaceToShowDetailViewFrom(Frame, Type, TargetWindow)Returns an Object Space in which a Detail View should be created. Inherited from XafApplication.
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. Inherited from XafApplication.
GetType()Gets the Type of the current instance. Inherited from Object.
GetUserChoice(String, MessageBoxButtons)Displays a message box with the specified text and set of buttons.
HandleException(Exception)Shows the message box with details on the specified exception.
InitializeLifetimeService()Obtains a lifetime service object to control the lifetime policy for this instance. Inherited from MarshalByRefObject.
LogOff()Closes all windows and displays the logon dialog.
Logon()Performs the logon. Inherited from XafApplication.
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. Inherited from XafApplication.
ReferenceEquals(Object, Object) staticDetermines whether the specified Object instances are the same instance. Inherited from Object.
RemoveSplash()Removes the WinApplication.SplashScreen splash.
Restart()Closes all windows, reinitializes and restarts the Windows Forms application.
SaveModelChanges()Saves the Application Model changes made by an end-user, up to the current moment, to the storage (Model.User.xafml file, by default).
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. Inherited from XafApplication.
SetLanguage(String)Sets the specified language for the current application when called before the application windows are shown. Inherited from XafApplication.
Setup()Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(ExpressApplicationSetupParameters)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, IObjectSpaceProvider, ApplicationModulesManager, ISecurityStrategyBase)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, IObjectSpaceProvider, String[], ISecurityStrategyBase)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, IObjectSpaceProvider)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, IList<IObjectSpaceProvider>, ApplicationModulesManager, ISecurityStrategyBase)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, IList<IObjectSpaceProvider>, String[], ISecurityStrategyBase)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, String, String[], ISecurityStrategyBase)Initializes the newly created XafApplication class instance. Inherited from XafApplication.
Setup(String, String, String[])Initializes the newly created XafApplication class instance. Inherited from XafApplication.
ShowDetailViewFrom(Frame)Indicates whether a Views invoked from the specified Frame can be displayed in a new Window.
Start()Starts the Windows Forms application.
StartOverlayForm(Control)Executes the DXSplashScreen.StartOverlayForm method.
StartSplash()Executes the DXSplashScreen.Start() method.
StartSplash(SplashType)Executes the DXSplashScreen.Start method
StopOverlayForm(IOverlaySplashScreenHandle)Executes the DXSplashScreen.StopOverlayForm method.
StopSplash()Executes the DXSplashScreen.Stop() method
StopSplash(SplashType)Executes the DXSplashScreen.Stop(SplashType) method.
ToString()Returns a String containing the name of the Component, if any. This method should not be overridden. Inherited from Component.
UpdateSplash(String, String, String, Object[])For internal use.
UpdateStatus(String, String, String, Object[])Triggers the XafApplication.StatusUpdating event.
WaitAndPump(Task, Int32, Boolean) static
WaitAndPump(Task, Int32) static

Events

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

See Also

WinApplication Class

DevExpress.ExpressApp.Win Namespace