System.IAppDomainSetup Interface

Assembly: Mscorlib.dll
Namespace: System
Summary
Represents assembly binding information that can be added to an instance of AppDomain.
C# Syntax:
public interface IAppDomainSetup
Remarks
Members of this interface are used with the AppDomain.GetData and AppDomain.SetData methods to identify the AppDomain data to use.
See also:
System Namespace

System.IAppDomainSetup Member List:

Public Properties
ApplicationBase Read-write

Gets or sets the name of the directory containing the application.
ApplicationName Read-write

Gets or sets the name of the application.
CachePath Read-write

Gets and sets the name of an area specific to the application where files are shadow copied.
ConfigurationFile Read-write

Gets and sets the name of the configuration file for an application domain.
DynamicBase Read-write

Gets or sets the directory where dynamically generated files are stored and accessed.
LicenseFile Read-write

Gets or sets the location of the license file associated with this domain.
PrivateBinPath Read-write

Gets or sets the list of directories that is combined with the AppDomainSetup.ApplicationBase directory to probe for private assemblies.
PrivateBinPathProbe Read-write

Gets or sets the private binary directory path used to locate an application.
ShadowCopyDirectories Read-write

Gets or sets the names of the directories containing assemblies to be shadow copied.
ShadowCopyFiles Read-write

Gets or sets a string that indicates whether shadow copying is turned on or off.

System.IAppDomainSetup Member Details

Property: ApplicationBase (read-write)
Summary
Gets or sets the name of the directory containing the application.
C# Syntax:
string ApplicationBase {get; set;}
Remarks
Used when getting or setting the assembly cache manager's APPBASE variable. This is the directory where the assembly manager should begin probing for assemblies. This property cannot be changed after the AppDomain has finished its first bind.

Return to top


Property: ApplicationName (read-write)
Summary
Gets or sets the name of the application.
C# Syntax:
string ApplicationName {get; set;}

Return to top


Property: CachePath (read-write)
Summary
Gets and sets the name of an area specific to the application where files are shadow copied.
C# Syntax:
string CachePath {get; set;}
See also:
IAppDomainSetup.ShadowCopyFiles | IAppDomainSetup.ShadowCopyDirectories

Return to top


Property: ConfigurationFile (read-write)
Summary
Gets and sets the name of the configuration file for an application domain.
C# Syntax:
string ConfigurationFile {get; set;}
Remarks
The configuration file describes the search rules and configuration data for the application domain. The host that creates the application domain is responsible for supplying this data because the meaningful values vary from situation to situation.

For example, the configuration data for ASP.NET applications is stored for each application, site, and computer, while the configuration data for an executable is stored for each application, user, and computer. Only the host knows the specifics of the configuration data for a particular circumstance.

This property cannot be changed after the AppDomain has finished its first bind.

Return to top


Property: DynamicBase (read-write)
Summary
Gets or sets the directory where dynamically generated files are stored and accessed.
C# Syntax:
string DynamicBase {get; set;}
Remarks
When an AppDomain is created, a directory called the Dynamic Directory can be specified to store dynamic assemblies. This directory is logically located under the AppDomainSetup.ApplicationBase, although it can reside in another part of the directory.

This property cannot be changed after the AppDomain has finished its first bind.

Return to top


Property: LicenseFile (read-write)
Summary
Gets or sets the location of the license file associated with this domain.
C# Syntax:
string LicenseFile {get; set;}

Return to top


Property: PrivateBinPath (read-write)
Summary
Gets or sets the list of directories that is combined with the AppDomainSetup.ApplicationBase directory to probe for private assemblies.
C# Syntax:
string PrivateBinPath {get; set;}
Remarks
Private assemblies are deployed in the same directory structure as the application.

Return to top


Property: PrivateBinPathProbe (read-write)
Summary
Gets or sets the private binary directory path used to locate an application.
C# Syntax:
string PrivateBinPathProbe {get; set;}
Remarks
Set this property to exclude the application directory path from the search for the application. The search is restricted to private and global binary directory paths, and the global assembly cache.

This property cannot be changed after the AppDomain has finished its first bind.

Return to top


Property: ShadowCopyDirectories (read-write)
Summary
Gets or sets the names of the directories containing assemblies to be shadow copied.
C# Syntax:
string ShadowCopyDirectories {get; set;}
Remarks
All directories specified by AppDomainSetup.PrivateBinPath, including the directory specified by AppDomainSetup.ApplicationBase, are shadow copied by default if this property is not set.

If an executable file is in use, updates to the executable file are stored in a shadow copy directory. Existing users continue using the original executable file until it terminates, while new users use the shadow copied executable file.

This property cannot be changed after the AppDomain has finished its first bind.

Return to top


Property: ShadowCopyFiles (read-write)
Summary
Gets or sets a string that indicates whether shadow copying is turned on or off.
C# Syntax:
string ShadowCopyFiles {get; set;}
Remarks
This property cannot be changed after the AppDomain has finished its first bind.

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.