Ensures that only a single instance of the application is running. If a duplicate instance is detected, it executes a specified action and optionally exits the application.

Declaration

public static void EnsureSingleInstance(Action onDuplicateInstance, bool exit = true)

Parameters

Type	Name	Description
Action	onDuplicateInstance	An Action to be executed if a duplicate instance is found. This action is intended to provide a way to notify the user or log the event of a duplicate instance attempt.
bool	exit	A boolean value indicating whether to exit the application if a duplicate instance is detected. Defaults to true, causing the application to exit.

Remarks

This method attempts to create a named Mutex based on the application's entry assembly name. If the mutex cannot be created because it already exists, this indicates that an instance of the application is already running.

| Edit this page View Source

IsDebugBuild()

Determines if the current build is a debug build.

Declaration

public static bool IsDebugBuild()

Returns

Type	Description
bool	A boolean value indicating whether the current build has debugging features enabled, typically signifying a debug build.

Remarks

This method checks for the presence of the DebuggableAttribute on the entry assembly and examines if JIT tracking is enabled, which is usually the case for builds compiled in a debug configuration. It's a useful check for altering behavior based on the build configuration without relying on preprocessor directives.

| Edit this page View Source

TryGetAppName()

Tries to get the application name from various sources.

Declaration

public static string? TryGetAppName()

Returns

Type	Description
string	The application name, or null if it cannot be determined.

Examples

var appName = TryGetAppName();

| Edit this page View Source

TryGetOrCreateAppNameDirectory(string[]?, bool, string[]?, bool)

Attempts to get or create the application name directory.

Optional array of base directories to search or create the application name directory in. If not provided, default directories will be used. Indicates whether to use a startup-specific application location. Optional array of default directories to ensure they exist within the application directory. Indicates whether to throw an exception if the operation fails. The path to the application name directory, or null if not found or created.

var configDir = MainContext.TryGetOrCreateAppNameDirectory();

Declaration

public static DirectoryInfo? TryGetOrCreateAppNameDirectory(string[]? baseDirectories = null, bool useStartupAppLocation = false, string[]? defaultDirectories = null, bool throwIfFails = false)

Parameters

Type	Name	Description
string[]	baseDirectories
bool	useStartupAppLocation
string[]	defaultDirectories
bool	throwIfFails

Returns

Type	Description
DirectoryInfo

| Edit this page View Source

TryGetPrimaryFileLocation()

Attempts to identify and return the primary file location of the currently executing application.

Declaration

public static string? TryGetPrimaryFileLocation()

Returns

Type	Description
string	The file path of the main module if its name matches the domain, or the location of the entry or calling assembly. Returns null if none of these locations can be determined.

Remarks

This method first tries to match the main executable's name with the current domain name. If no match is found, it attempts to retrieve the location from the entry assembly or, if that is not available, from the calling assembly. This method is useful for applications that need to determine the path of the currently running executable or assembly.