# Application
Namespace: **Wisej.Web**
Assembly: **Wisej.Framework** (4.0.0.0)
Represent a Wisej application session. Provides methods and events to manage the application in the context of the current session.
{% tabs %}
{% tab title="C#" %}
```csharp
public class Application : IWisejComponent, IDisposable, IWisejSynchronized
```
{% endtab %}
{% tab title="VB.NET" %}
```visual-basic
Public Class Application
Inherits IWisejComponent
Implements IDisposable, IWisejSynchronized
```
{% endtab %}
{% endtabs %}
This class provides several static methods, properties and events that allow the application to manage all sorts of features related to the current session:
* Save and retrieve session variable. Use [Session](#session) to store and retrieve session variable. The property is a dynamic object and a [Dictionary](https://docs.microsoft.com/dotnet/api/system.collections.generic.dictionary-2), therefore you can access its properties directly or through the indexer.
```csharp
Application.Session.myValue = 12;
Application.Session["myValue"] = 12;
```
* Manage cookies. Use [Cookies](#cookies) to manage browser's cookies.
* Read server variables. Use [ServerVariables](#servervariables) to retrieve all the data made available by the server. Some of the variables in the collection are also available directly: [ServerPort](#serverport), [ServerName](#servername), [UserAgent](#useragent), etc.
* Read the application's URL. Use [Uri](#uri), [Url](#url), [StartupUri](#startupuri), and [StartupUrl](#startupurl).
* Read the application's system information. Use [StartupPath](#startuppath), [ProductName](#productname), [ProductVersion](#productversion), etc.
* Listen to the application's global events. See [SessionTimeout](#sessiontimeout) , [BeginRequest](#beginrequest), [ApplicationStart](#applicationstart), [ApplicationExit](#applicationexit)[ApplicationRefresh](#applicationrefresh), [BrowserSizeChanged](#browsersizechanged)[ResponsiveProfileChanged](#responsiveprofilechanged), [CultureChanged](#culturechanged), and many more.
* Retrieve browser related information. Use the [Browser](#browser) to read the client browser type, OS, version, capabilities, screen size, browser size, language, and state. The [Browser](#browser) object is updated automatically when the user resizes the browser or the page is reloaded.
* Control the client browser. Start a [Download](#download-filepath-filename-ondownload), execute JavaScript functions or scriptlets using [Call](#call-function-args) or [Eval](#eval-script). Make the browser navigate to a different URL using [Navigate](#navigate-url-target) or simply [Reload](#reload) the page.
* Manage the main page or current desktop. [MainPage](#mainpage) lets you change the [Page](https://docs.wisej.com/api/wisej.web/containers/wisej.web.page) object that fills the browser and "navigate" from page to page. [Desktop](#desktop) lets you change the active [Desktop](https://docs.wisej.com/api/wisej.web/containers/desktop) object on the client browser.
* Manage all live components in the session. Through the [Application](https://docs.wisej.com/api/wisej.web/general/application) class you can find, iterate, inspect all live components of any type. See [OpenForms](#openforms) for all the currently created (visible or invisible) instances of [Form](https://docs.wisej.com/api/wisej.web/containers/form). [OpenPages](#openpages) returns all the created [Page](https://docs.wisej.com/api/wisej.web/containers/wisej.web.page) objects. [FindComponent](#findcomponent-match) and [FindComponents](#findcomponents-match) provide an easy way to find any component in the session or to iterate the list of components that match a custom expression.
* Start background tasks in context. [StartTask](#starttask-action) provides a powerful way to start a background task on the server that can keep interacting with the client browser while running independently.
* Manage the application's theme. Use [LoadTheme](#loadtheme-name-mixins) to load a Wisej theme into the application. Or use the [Theme](#theme) object to read all sorts of information from the current [ClientTheme](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clienttheme).
* Terminate the application without waiting for the session to timeout. Use [Exit](#exit) to terminate the current session and free all the related memory.
There is a lot more exposed by the [Application](https://docs.wisej.com/api/wisej.web/general/application) class. You can inspect all the properties and methods in Visual Studio through IntelliSense or online at [docs.wisej](https://docs.wisej.com).
## Properties
###  ActiveProfile
[ClientProfile](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clientprofile): Returns or sets the current client responsive profile.
This is the profile that best matches the current browser on the client. It is updated automatically on every request.
###  Browser
[ClientBrowser](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clientbrowser): Returns or the client browser's information.
###  ClientCertificate
[X509Certificate2](https://docs.microsoft.com/dotnet/api/system.security.cryptography.x509certificates.x509certificate2): EXPERIMENTAL: Provides the client certificate fields issued by the client in response to the server's request for the client's identity. Since 3.5.6
###  ClientId
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the current unique client id.
###  Clients
[ClientCollection](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clientcollection): Returns a collection of all the unique client browsers using the application.
###  CommandManager
[CommandManager](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.commandmanager): Returns the current [CommandManager](#commandmanager).
###  CommonAppDataPath
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the path for the application data that is shared among all users.
###  CommonAppDataRegistry
[RegistryKey](https://docs.microsoft.com/dotnet/api/microsoft.win32.registrykey): Returns the registry key for the application data that is shared among all users.
###  CompanyName
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the company name associated with the application stored in the [AssemblyCompanyAttribute](https://docs.microsoft.com/dotnet/api/system.reflection.assemblycompanyattribute).
###  Configuration
[Configuration](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.configuration): Returns the current [Configuration](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.configuration).
###  Cookies
[CookieCollection](https://docs.wisej.com/api/wisej.base/general/wisej.base.cookiecollection): Collection of cookies.
###  Current
[IWisejComponent](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejcomponent): Returns the application component instance that an application can store and use later to restore the context when updating client widgets during an out-of-bound call using the [Update](#update-context-action) method.
Threads that are not started using [StartTask](#starttask-action) don't have any knowledge of the current session and don't have a way to communicate with the client The [Current](#current) property returns the instance of the [Application](https://docs.wisej.com/api/wisej.web/general/application) class that is bound to the current session. It can be used just like any other component with the method [Update](#update-context-action) or [RunInContext](#runincontext-context-action) to restore the session for the current thread. The advantage of using [Current](#current) instead of the instance of a control or a page is to avoid to keep a reference to a component that may be disposed by the application.
```csharp
var current = Application.Current;
var thread = new Thread(() => {
Application.Update(current, () => {
// code here is running in context.
});
});
```
###  CurrentCulture
[CultureInfo](https://docs.microsoft.com/dotnet/api/system.globalization.cultureinfo): Returns or sets the current [CultureInfo](https://docs.microsoft.com/dotnet/api/system.globalization.cultureinfo) for the session.
###  Desktop
[Desktop](https://docs.wisej.com/api/wisej.web/containers/desktop): Returns or sets the current Desktop.
###  EnableUnloadConfirmation
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the browser will ask the user to confirm unloading the current page.
This property attaches the window\.onbeforeunload event. See . It's not possible to determine whether the page is being unloaded because the user is trying to close the tab, close the browser, or is refreshing the page, or is taking any other action that may reload the page.
###  ExecutablePath
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the path for the application's main assembly.
###  FavIcon
[Image](https://docs.microsoft.com/dotnet/api/system.drawing.image): Returns or sets the favicon to display in the browser.
###  FavIconSource
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the URL to the favicon to display in the browser.
###  Hash
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the hash part of the URL on the client.
###  IsAuthenticated
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns a value indicating whether the session has been authenticated.
###  IsDisposed
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Indicates that the current application instance, which corresponds to the session, has been terminated and disposed.
###  IsExpired
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns true when the current session has expired.
###  IsSecure
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns true if this session is running in secure mode (https\:// and wss\://)
###  IsTerminated
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns true when the current session has been terminated.
###  IsWebSocket
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns true if the current session is connected using WebSocket.
###  LicenseInfo
[Object](https://docs.microsoft.com/dotnet/api/system.object): Returns a dynamic object containing the currently loaded license information. Since 3.1.3
These are the currently available fields (may change in future releases):
* Valid: Whether the license is valid. Note that a license may be expired and valid if the product release date is within the license expiration date.
* LicenseKey: License key loaded from web.config or assigned to [LicenseKey](#licensekey).
* ProductName: Full name of the licensed product.
* CustomerName: Name of the registered customer that owns the license.
* ExpirationDate: Expiration date for the product free updates.
Retrieve the values either using a dynamic object or a property indexer:
```csharp
string productName = Application.LicenseInfo.ProductName;
string customerName = Application.LicenseInfo["CustomerName"];
```
###  LicenseKey
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the runtime server license key.
Setting the [LicenseKey](#licensekey) programmatically has to be done before the application is loaded. The best place is the static constructor for the Program static class, or the static constructor of the main window (if defined in Default.js).
```csharp
static class Program
{
static Program()
{
Application.LicenseKey = "...";
}
}
```
###  MainPage
[Page](https://docs.wisej.com/api/wisej.web/containers/wisej.web.page): Returns or sets the current full page window.
###  OpenForms
[FormCollection](https://docs.wisej.com/api/wisej.web/general/application/wisej.web.application.formcollection): Returns a collection of open forms owned by the application.
###  OpenPages
[PageCollection](https://docs.wisej.com/api/wisej.web/general/application/wisej.web.application.pagecollection): Returns a collection of open pages owned by the application.
###  Platform
[ClientPlatform](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clientplatform): The name of the currently loaded platform.
###  ProductName
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the product name associated with this application.
###  ProductVersion
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the product version associated with this application stored either in [AssemblyInformationalVersionAttribute](https://docs.microsoft.com/dotnet/api/system.reflection.assemblyinformationalversionattribute) or [AssemblyFileVersionAttribute](https://docs.microsoft.com/dotnet/api/system.reflection.assemblyfileversionattribute).
###  QueryString
[NameValueCollection](https://docs.microsoft.com/dotnet/api/system.collections.specialized.namevaluecollection): Returns the parameters used to launch the application.
###  Referrer
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the original URL from the first "HTTP\_REFERER" header. Corresponds to the new custom server variable "ORIGINAL\_REFERRER".
This value is an empty string in most cases, since it contains the URL of the first non Wisej.NET page loaded in the browser, from which a user has clicked an hyperlink to navigate to the Wisej.NET application.
###  RightToLeft
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether all the controls in the applications should operate using the right-to-left mode.
The value of this property is updated automatically when the current language changes if the value of "rightToLeft" in the application configuration file is set to "auto".
###  RuntimeMode
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns true when the application is running in not in design, debug or test mode.
###  ServerName
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the server's host name, DNS alias, or IP address as it would appear in self-referencing URLs.
###  ServerPort
[Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns the port number to which the request was sent.
###  ServerVariables
[NameValueCollection](https://docs.microsoft.com/dotnet/api/system.collections.specialized.namevaluecollection): Returns the server variables.
###  Services
[ServiceProvider](https://docs.wisej.com/api/wisej.services/general/wisej.services.serviceprovider): Returns the [ServiceProvider](https://docs.wisej.com/api/wisej.services/general/wisej.services.serviceprovider) implementation used by Wisej.NET to manage Dependency Injection across the application. Since 3.1
###  Session
[Object](https://docs.microsoft.com/dotnet/api/system.object): Provides a generic storage for session-based objects.
###  SessionCount
[Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns the total number of currently active sessions.
###  SessionId
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the unique current session ID.
###  ShowConsole
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Shows or hides the debug console on the browser.
Displays a simple HTMl only debug console. Works with any browser also when the developer tools are not available.
###  ShowLoader
[Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the browser is blocked by the Ajax loader.
###  StartupPath
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the root path of the web application.
###  StartupUri
[Uri](https://docs.microsoft.com/dotnet/api/system.uri): Returns the URI used to start the application.
###  StartupUrl
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the URL used to start the application.
###  Theme
[ClientTheme](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clienttheme): Returns or sets the current [ClientTheme](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clienttheme).
You can create and modify a new custom theme using the [ClientTheme](https://docs.wisej.com/api/wisej.web/general/application/wisej.core.clienttheme) class. The new theme can be based on an existing theme, can be empty, or can be initialized from a JSON string.
```csharp
// create a new custom theme cloned from the current theme.
var myTheme = new ClientTheme("MyTheme", Application.Theme);
// alter the buttonFace color.
myTheme.Colors.buttonFace = "red";
// update the current session using the new custom theme.
Application.Theme = myTheme;
```
You may also alter a global theme shared by all sessions.
```csharp
// change the buttonFace color in the current theme.
// if the theme is one of the global themes, i.e. it was loaded
// using Application.LoadTheme(name), then the change is also global.
Application.Theme.Colors.buttonFace = "red";
// since the theme objects are all dynamic and use a special DynamicObject
// class part of the Wisej Framework, you can also use a string indexer
// to address any field.
Application.Theme.Colors["buttonFace"] = "red";
```
###  Title
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the page title in the browser.
###  Uri
[Uri](https://docs.microsoft.com/dotnet/api/system.uri): Returns the current [Uri](https://docs.microsoft.com/dotnet/api/system.uri) used either to launch or reload the application. It may be different from [StartupUri](#startupuri).
###  Url
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the current URL used either to launch or reload the application. It may be different from [StartupUrl](#startupurl).
###  User
[IPrincipal](https://docs.microsoft.com/dotnet/api/system.security.principal.iprincipal): Returns the security information for the current request.
###  UserAgent
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the raw user agent string of the client browser.
###  UserHostAddress
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the IP host address of the remote client.
###  UserHostName
[String](https://docs.microsoft.com/dotnet/api/system.string): Returns the DNS name of the remote client.
###  UserIdentity
[WindowsIdentity](https://docs.microsoft.com/dotnet/api/system.security.principal.windowsidentity): Returns the [WindowsIdentity](https://docs.microsoft.com/dotnet/api/system.security.principal.windowsidentity) type for the current user.
###  UserLanguages
[String\[\]](https://docs.microsoft.com/dotnet/api/system.string): Gets a sorted string array of client language preferences.
## Methods
###  AddEventFilter(filter)
Adds an event filter to monitor all the incoming events before they are routed to their respective component.
| Parameter | Type | Description |
| ---------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **filter** | [IEventFilter](https://docs.wisej.com/api/wisej.core/general/wisej.core.ieventfilter) | An object that implements the [IEventFilter](https://docs.wisej.com/api/wisej.core/general/wisej.core.ieventfilter) interface to add to the filter list. |
###  AddTranslation(text, translation)
Adds the text and corresponding translation to the default locale on the client.
| Parameter | Type | Description |
| --------------- | ------------------------------------------------------------- | ------------------------- |
| **text** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The text to translate. |
| **translation** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The translation override. |
###  AlertAsync(message)
Instructs the browser to display a dialog with an optional message, and to wait until the user dismisses the dialog.
| Parameter | Type | Description |
| ----------- | ------------------------------------------------------------- | ------------------------------------------------- |
| **message** | [String](https://docs.microsoft.com/dotnet/api/system.string) | A string you want to display in the alert dialog. |
**Returns:** [Task](https://docs.microsoft.com/dotnet/api/system.threading.tasks.task). An awaitable [Task](https://docs.microsoft.com/dotnet/api/system.threading.tasks.task) that represents the asynchronous operation.
###  Call(function, args)
Executes the JavaScript function on the client.
| Parameter | Type | Description |
| ------------ | ----------------------------------------------------------------- | -------------------------------------- |
| **function** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The name of the function to execute. |
| **args** | [Object\[\]](https://docs.microsoft.com/dotnet/api/system.object) | The arguments to pass to the function. |
###  Call(function, callback, args)
Executes the JavaScript function on the client and receives the return value (or null) in the *callback* method.
| Parameter | Type | Description |
| ------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------ |
| **function** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The name of the function to execute. |
| **callback** | [Action\