## Application Domains

### Synopsis

#include <metadata/appdomain.h> /* Managed AppDomain */ typedef struct _MonoAppDomain MonoAppDomain; /* Unmanaged representation */ typedef struct _MonoDomain MonoDomain; /* Represents System.Runtime.Remoting.Contexts.Context */ typedef struct _MonoAppContext MonoAppContext MonoAssembly* mono_domain_assembly_open (MonoDomain *domain, const char *name); MonoDomain* mono_domain_create (void); MonoDomain* mono_domain_create_appdomain (char *friendly_name, char *configuration_file); gboolean mono_domain_finalize (MonoDomain *domain, guint32 timeout) ; void mono_domain_foreach (MonoDomainFunc func, gpointer user_data); void mono_domain_free (MonoDomain *domain, gboolean force); mono_domain_from_appdomain MonoDomain* mono_domain_get_by_id (gint32 domainid) ; mono_domain_get_friendly_name mono_domain_get_id MonoDomain* mono_domain_get (); gboolean mono_domain_has_type_resolve (MonoDomain *domain); mono_domain_is_unloading gboolean mono_domain_owns_vtable_slot (MonoDomain *domain, gpointer vtable_slot); void mono_domain_set_config (MonoDomain *domain, const char *base_dir, const char *config_file_name); void mono_domain_set_internal (MonoDomain *domain); gboolean mono_domain_set (MonoDomain *domain, gboolean force); MonoReflectionAssembly* mono_domain_try_type_resolve (MonoDomain *domain, char *name, MonoObject *tb); mono_domain_try_unload mono_domain_unload void mono_context_init (MonoDomain *domain); MonoAppContext* mono_context_get (void); gint32 mono_context_get_domain_id (MonoAppContext *context); gint32 mono_context_get_id (MonoAppContext *context); mono_context_set mono_context_get_desc

Application domains are used to isolate multiple applications on a single Mono virtual machine. They are conceptually similiar to processes, the difference is that processes are managed by the operating system, while application domains are managed by the Mono virtual machine.

For more information on applications domains see the AppDomain FAQ.

The `MonoDomain` is the unmanaged representation of the System.AppDomain managed type, while the `MonoAppDomain` type represents the managed version (`MonoAppDomain` has a pointer to a `MonoDomain`).

`mono_domain_assembly_open`
Syntax
MonoAssembly* mono_domain_assembly_open (MonoDomain *domain, const char *name)

Parameters

domain | the application domain
name | file name of the assembly

Description

fixme: maybe we should integrate this with mono_assembly_open ??

`mono_domain_create`
Syntax
MonoDomain* mono_domain_create (void)

Return value
New initialized MonoDomain, with no configuration or assemblies loaded into it.
Description

Creates a new application domain, the unmanaged representation of the actual domain. Usually you will want to create the

Application domains provide an isolation facilty for assemblies. You can load assemblies and execute code in them that will not be visible to other application domains. This is a runtime-based virtualization technology.

It is possible to unload domains, which unloads the assemblies and data that was allocated in that domain.

When a domain is created a mempool is allocated for domain-specific structures, along a dedicated code manager to hold code that is associated with the domain.

`mono_domain_create_appdomain`
Syntax
MonoDomain* mono_domain_create_appdomain (char *friendly_name, char *configuration_file)

Parameters

friendly_name | The friendly name of the appdomain to create
configuration_file | The configuration file to initialize the appdomain with

Description

Returns a MonoDomain initialized with the appdomain

`mono_domain_finalize`
Syntax
gboolean mono_domain_finalize (MonoDomain *domain, guint32 timeout)

Parameters

domain | the domain to finalize
timeout | msects to wait for the finalization to complete, -1 to wait indefinitely

Return value
`TRUE` if succeeded, `FALSE` if there was a timeout
Description

Request finalization of all finalizable objects inside domain. Wait timeout msecs for the finalization to complete.

`mono_domain_foreach`
Syntax
void mono_domain_foreach (MonoDomainFunc func, gpointer user_data)

Parameters

func | function to invoke with the domain data
user_data | user-defined pointer that is passed to the supplied func fo reach domain

Description

Use this method to safely iterate over all the loaded application domains in the current runtime. The provided func is invoked with a pointer to the MonoDomain and is given the value of the user_data parameter which can be used to pass state to your called routine.

`mono_domain_free`
Syntax
void mono_domain_free (MonoDomain *domain, gboolean force)

Parameters

domain | the domain to release
force | if true, it allows the root domain to be released (used at shutdown only).

Description

This releases the resources associated with the specific domain. This is a low-level function that is invoked by the AppDomain infrastructure when necessary.

`mono_domain_from_appdomain`
Syntax
mono_domain_from_appdomain

`mono_domain_get_by_id`
Syntax
MonoDomain* mono_domain_get_by_id (gint32 domainid)

Parameters

domainid | the ID

Return value
the domain for a specific domain id.
Description

`mono_domain_get_friendly_name`
Syntax
mono_domain_get_friendly_name

`mono_domain_get_id`
Syntax
mono_domain_get_id

`mono_domain_get`
Syntax
MonoDomain* mono_domain_get ()

Return value
the current domain
Description

This method returns the value of the current MonoDomain that this thread and code are running under. To obtain the root domain use mono_get_root_domain() API.

`mono_domain_has_type_resolve`
Syntax
gboolean mono_domain_has_type_resolve (MonoDomain *domain)

Parameters

domain | application domains being looked up

Return value
`TRUE` if the AppDomain.TypeResolve field has been set.
Description

`mono_domain_is_unloading`
Syntax
mono_domain_is_unloading

`mono_domain_owns_vtable_slot`
Syntax
gboolean mono_domain_owns_vtable_slot (MonoDomain *domain, gpointer vtable_slot)

Description

Returns whenever VTABLE_SLOT is inside a vtable which belongs to DOMAIN.

`mono_domain_set_config`
Syntax
void mono_domain_set_config (MonoDomain *domain, const char *base_dir, const char *config_file_name)

Parameters

domain | MonoDomain initialized with the appdomain we want to change
base_dir | new base directory for the appdomain
config_file_name | path to the new configuration for the app domain

Description

Used to set the system configuration for an appdomain

Without using this, embedded builds will get 'System.Configuration.ConfigurationErrorsException: Error Initializing the configuration system. ---> System.ArgumentException: The 'ExeConfigFilename' argument cannot be null.' for some managed calls.

`mono_domain_set_internal`
Syntax
void mono_domain_set_internal (MonoDomain *domain)

Parameters

domain | the new domain

Description

Sets the current domain to domain.

`mono_domain_set`
Syntax
gboolean mono_domain_set (MonoDomain *domain, gboolean force)

Parameters

domain | domain
force | force setting.

Return value
`TRUE` on success; `FALSE` if the domain is unloaded
Description

Set the current appdomain to domain. If force is set, set it even if it is being unloaded.

`mono_domain_try_type_resolve`
Syntax
MonoReflectionAssembly* mono_domain_try_type_resolve (MonoDomain *domain, char *name, MonoObject *tb)

Parameters

domain | application domainwhere the name where the type is going to be resolved
name | the name of the type to resolve or `NULL`.
tb | A System.Reflection.Emit.TypeBuilder, used if name is `NULL`.

Return value
A MonoReflectionAssembly or `NULL` if not found
Description

This routine invokes the internal System.AppDomain.DoTypeResolve and returns the assembly that matches name.

If name is null, the value of ((TypeBuilder)tb).FullName is used instead

`mono_domain_try_unload`
Syntax
mono_domain_try_unload

`mono_domain_unload`
Syntax
mono_domain_unload

### Contexts

`mono_context_init`
Syntax
void mono_context_init (MonoDomain *domain)

Parameters

domain | The domain where the System.Runtime.Remoting.Context.Context is initialized

Description

Initializes the domain's default System.Runtime.Remoting's Context.

`mono_context_get`
Syntax
MonoAppContext* mono_context_get (void)

Return value
the current Mono Application Context.
Description

`mono_context_get_domain_id`
Syntax
gint32 mono_context_get_domain_id (MonoAppContext *context)

Parameters

context | the context to operate on.

Return value
The ID of the domain that context was created in.
Description

`mono_context_get_id`
Syntax
gint32 mono_context_get_id (MonoAppContext *context)

Parameters

context | the context to operate on.

Return value
The unique ID for context.
Description

Context IDs are guaranteed to be unique for the duration of a Mono process; they are never reused.

`mono_context_set`
Syntax
mono_context_set