mscorlib(4.0.0.0) API with additions
System.AppDomainSetup Class Reference

Represents assembly binding information that can be added to an instance of T:System.AppDomain. More...

Inheritance diagram for System.AppDomainSetup:
[legend]
Collaboration diagram for System.AppDomainSetup:
[legend]

Public Member Functions

 AppDomainSetup ()
 Initializes a new instance of the T:System.AppDomainSetup class. More...
 
 AppDomainSetup (ActivationContext activationContext)
 Initializes a new instance of the T:System.AppDomainSetup class with the specified activation context to use for manifest-based activation of an application domain. More...
 
 AppDomainSetup (ActivationArguments activationArguments)
 Initializes a new instance of the T:System.AppDomainSetup class with the specified activation arguments required for manifest-based activation of an application domain. More...
 
byte [] GetConfigurationBytes ()
 Returns the XML configuration information set by the M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[]) method, which overrides the application's XML configuration information. More...
 
void SetConfigurationBytes (byte[] value)
 Provides XML configuration information for the application domain, replacing the application's XML configuration information. More...
 
void SetCompatibilitySwitches (IEnumerable< string > switches)
 Sets the specified switches, making the application domain compatible with previous versions of the .NET Framework for the specified issues. More...
 
void SetNativeFunction (string functionName, int functionVersion, IntPtr functionPointer)
 Provides the common language runtime with an alternate implementation of a string comparison function. More...
 

Properties

string AppDomainManagerAssembly [get, set]
 Gets or sets the display name of the assembly that provides the type of the application domain manager for application domains created using this T:System.AppDomainSetup object. More...
 
string AppDomainManagerType [get, set]
 Gets or sets the full name of the type that provides the application domain manager for application domains created using this T:System.AppDomainSetup object. More...
 
string [] PartialTrustVisibleAssemblies [get, set]
 Gets or sets a list of assemblies marked with the F:System.Security.PartialTrustVisibilityLevel.NotVisibleByDefault flag that are made visible to partial-trust code running in a sandboxed application domain. More...
 
string ApplicationBase [get, set]
 Gets or sets the name of the directory containing the application. More...
 
string ConfigurationFile [get, set]
 Gets or sets the name of the configuration file for an application domain. More...
 
string TargetFrameworkName [get, set]
 Gets or sets a string that specifies the target version and profile of the .NET Framework for the application domain, in a format that can be parsed by the M:System.Runtime.Versioning.FrameworkName.::ctor(System.String) constructor. More...
 
string DynamicBase [get, set]
 Gets or sets the base directory where the directory for dynamically generated files is located. More...
 
bool DisallowPublisherPolicy [get, set]
 Gets or sets a value that indicates whether the <publisherPolicy> section of the configuration file is applied to an application domain. More...
 
bool DisallowBindingRedirects [get, set]
 Gets or sets a value that indicates whether an application domain allows assembly binding redirection. More...
 
bool DisallowCodeDownload [get, set]
 Gets or sets a value that indicates whether HTTP download of assemblies is allowed for an application domain. More...
 
bool DisallowApplicationBaseProbing [get, set]
 Specifies whether the application base path and private binary path are probed when searching for assemblies to load. More...
 
string ApplicationName [get, set]
 Gets or sets the name of the application. More...
 
AppDomainInitializer AppDomainInitializer [get, set]
 Gets or sets the T:System.AppDomainInitializer delegate, which represents a callback method that is invoked when the application domain is initialized. More...
 
string [] AppDomainInitializerArguments [get, set]
 Gets or sets the arguments passed to the callback method represented by the T:System.AppDomainInitializer delegate. The callback method is invoked when the application domain is initialized. More...
 
ActivationArguments ActivationArguments [get, set]
 Gets or sets data about the activation of an application domain. More...
 
ApplicationTrust ApplicationTrust [get, set]
 Gets or sets an object containing security and trust information. More...
 
string PrivateBinPath [get, set]
 Gets or sets the list of directories under the application base directory that are probed for private assemblies. More...
 
string PrivateBinPathProbe [get, set]
 Gets or sets a string value that includes or excludes P:System.AppDomainSetup.ApplicationBase from the search path for the application, and searches only P:System.AppDomainSetup.PrivateBinPath. More...
 
string ShadowCopyDirectories [get, set]
 Gets or sets the names of the directories containing assemblies to be shadow copied. More...
 
string ShadowCopyFiles [get, set]
 Gets or sets a string that indicates whether shadow copying is turned on or off. More...
 
string CachePath [get, set]
 Gets or sets the name of an area specific to the application where files are shadow copied. More...
 
string LicenseFile [get, set]
 Gets or sets the location of the license file associated with this domain. More...
 
LoaderOptimization LoaderOptimization [get, set]
 Specifies the optimization policy used to load an executable. More...
 
bool SandboxInterop [get, set]
 Gets or sets a value that indicates whether interface caching is disabled for interop calls in the application domain, so that a QueryInterface is performed on each call. More...
 
- Properties inherited from System.IAppDomainSetup
string ApplicationBase [get, set]
 Gets or sets the name of the directory containing the application. More...
 
string ApplicationName [get, set]
 Gets or sets the name of the application. More...
 
string CachePath [get, set]
 Gets and sets the name of an area specific to the application where files are shadow copied. More...
 
string ConfigurationFile [get, set]
 Gets and sets the name of the configuration file for an application domain. More...
 
string DynamicBase [get, set]
 Gets or sets the directory where dynamically generated files are stored and accessed. More...
 
string LicenseFile [get, set]
 Gets or sets the location of the license file associated with this domain. More...
 
string PrivateBinPath [get, set]
 Gets or sets the list of directories that is combined with the P:System.AppDomainSetup.ApplicationBase directory to probe for private assemblies. More...
 
string PrivateBinPathProbe [get, set]
 Gets or sets the private binary directory path used to locate an application. More...
 
string ShadowCopyDirectories [get, set]
 Gets or sets the names of the directories containing assemblies to be shadow copied. More...
 
string ShadowCopyFiles [get, set]
 Gets or sets a string that indicates whether shadow copying is turned on or off. More...
 

Detailed Description

Represents assembly binding information that can be added to an instance of T:System.AppDomain.

Definition at line 21 of file AppDomainSetup.cs.

Constructor & Destructor Documentation

◆ AppDomainSetup() [1/3]

System.AppDomainSetup.AppDomainSetup ( )

Initializes a new instance of the T:System.AppDomainSetup class.

Definition at line 682 of file AppDomainSetup.cs.

◆ AppDomainSetup() [2/3]

System.AppDomainSetup.AppDomainSetup ( ActivationContext  activationContext)

Initializes a new instance of the T:System.AppDomainSetup class with the specified activation context to use for manifest-based activation of an application domain.

Parameters
activationContextThe activation context to be used for an application domain.
Exceptions
T:System.ArgumentNullExceptionactivationContext is null.

Definition at line 691 of file AppDomainSetup.cs.

◆ AppDomainSetup() [3/3]

System.AppDomainSetup.AppDomainSetup ( ActivationArguments  activationArguments)

Initializes a new instance of the T:System.AppDomainSetup class with the specified activation arguments required for manifest-based activation of an application domain.

Parameters
activationArgumentsAn object that specifies information required for the manifest-based activation of a new application domain.
Exceptions
T:System.ArgumentNullExceptionactivationArguments is null.

Definition at line 701 of file AppDomainSetup.cs.

Member Function Documentation

◆ GetConfigurationBytes()

byte [] System.AppDomainSetup.GetConfigurationBytes ( )

Returns the XML configuration information set by the M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[]) method, which overrides the application's XML configuration information.

Returns
An array that contains the XML configuration information that was set by the M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[]) method, or null if the M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[]) method has not been called.

Definition at line 915 of file AppDomainSetup.cs.

◆ SetCompatibilitySwitches()

void System.AppDomainSetup.SetCompatibilitySwitches ( IEnumerable< string >  switches)

Sets the specified switches, making the application domain compatible with previous versions of the .NET Framework for the specified issues.

Parameters
switchesAn enumerable set of string values that specify compatibility switches, or null to erase the existing compatibility switches.

Definition at line 938 of file AppDomainSetup.cs.

◆ SetConfigurationBytes()

void System.AppDomainSetup.SetConfigurationBytes ( byte []  value)

Provides XML configuration information for the application domain, replacing the application's XML configuration information.

Parameters
valueAn array that contains the XML configuration information to be used for the application domain.

Definition at line 926 of file AppDomainSetup.cs.

◆ SetNativeFunction()

void System.AppDomainSetup.SetNativeFunction ( string  functionName,
int  functionVersion,
IntPtr  functionPointer 
)

Provides the common language runtime with an alternate implementation of a string comparison function.

Parameters
functionNameThe name of the string comparison function to override.
functionVersionThe function version. For .NET Framework 4.5, its value must be 1 or greater.
functionPointerA pointer to the function that overrides functionName .
Exceptions
T:System.ArgumentExceptionfunctionName is null.
T:System.ArgumentNullExceptionfunctionVersion is not 1 or greater.-or- functionPointer is F:System.IntPtr.Zero.

Definition at line 990 of file AppDomainSetup.cs.

Property Documentation

◆ ActivationArguments

ActivationArguments System.AppDomainSetup.ActivationArguments
getset

Gets or sets data about the activation of an application domain.

Returns
An object that contains data about the activation of an application domain.
Exceptions
T:System.InvalidOperationExceptionThe property is set to an T:System.Runtime.Hosting.ActivationArguments object whose application identity does not match the application identity of the T:System.Security.Policy.ApplicationTrust object returned by the P:System.AppDomainSetup.ApplicationTrust property. No exception is thrown if the P:System.AppDomainSetup.ApplicationTrust property is null.

Definition at line 447 of file AppDomainSetup.cs.

◆ AppDomainInitializer

AppDomainInitializer System.AppDomainSetup.AppDomainInitializer
getset

Gets or sets the T:System.AppDomainInitializer delegate, which represents a callback method that is invoked when the application domain is initialized.

Returns
A delegate that represents a callback method that is invoked when the application domain is initialized.

Definition at line 417 of file AppDomainSetup.cs.

◆ AppDomainInitializerArguments

string [] System.AppDomainSetup.AppDomainInitializerArguments
getset

Gets or sets the arguments passed to the callback method represented by the T:System.AppDomainInitializer delegate. The callback method is invoked when the application domain is initialized.

Returns
An array of strings that is passed to the callback method represented by the T:System.AppDomainInitializer delegate, when the callback method is invoked during T:System.AppDomain initialization.

Definition at line 431 of file AppDomainSetup.cs.

◆ AppDomainManagerAssembly

string System.AppDomainSetup.AppDomainManagerAssembly
getset

Gets or sets the display name of the assembly that provides the type of the application domain manager for application domains created using this T:System.AppDomainSetup object.

Returns
The display name of the assembly that provides the T:System.Type of the application domain manager.

Definition at line 108 of file AppDomainSetup.cs.

◆ AppDomainManagerType

string System.AppDomainSetup.AppDomainManagerType
getset

Gets or sets the full name of the type that provides the application domain manager for application domains created using this T:System.AppDomainSetup object.

Returns
The full name of the type, including the namespace.

Definition at line 122 of file AppDomainSetup.cs.

◆ ApplicationBase

string System.AppDomainSetup.ApplicationBase
getset

Gets or sets the name of the directory containing the application.

Returns
The name of the application base directory.

Definition at line 158 of file AppDomainSetup.cs.

◆ ApplicationName

string System.AppDomainSetup.ApplicationName
getset

Gets or sets the name of the application.

Returns
The name of the application.

Definition at line 400 of file AppDomainSetup.cs.

◆ ApplicationTrust

ApplicationTrust System.AppDomainSetup.ApplicationTrust
getset

Gets or sets an object containing security and trust information.

Returns
An object that contains security and trust information.
Exceptions
T:System.InvalidOperationExceptionThe property is set to an T:System.Security.Policy.ApplicationTrust object whose application identity does not match the application identity of the T:System.Runtime.Hosting.ActivationArguments object returned by the P:System.AppDomainSetup.ActivationArguments property. No exception is thrown if the P:System.AppDomainSetup.ActivationArguments property is null.
T:System.ArgumentNullExceptionThe property is set to null.

Definition at line 464 of file AppDomainSetup.cs.

◆ CachePath

string System.AppDomainSetup.CachePath
getset

Gets or sets the name of an area specific to the application where files are shadow copied.

Returns
The fully qualified name of the directory path and file name where files are shadow copied.

Definition at line 556 of file AppDomainSetup.cs.

◆ ConfigurationFile

string System.AppDomainSetup.ConfigurationFile
getset

Gets or sets the name of the configuration file for an application domain.

Returns
The name of the configuration file.

Definition at line 175 of file AppDomainSetup.cs.

◆ DisallowApplicationBaseProbing

bool System.AppDomainSetup.DisallowApplicationBaseProbing
getset

Specifies whether the application base path and private binary path are probed when searching for assemblies to load.

Returns
true if probing is not allowed; otherwise, false. The default is false.

Definition at line 322 of file AppDomainSetup.cs.

◆ DisallowBindingRedirects

bool System.AppDomainSetup.DisallowBindingRedirects
getset

Gets or sets a value that indicates whether an application domain allows assembly binding redirection.

Returns
true if redirection of assemblies is not allowed; false if it is allowed.

Definition at line 278 of file AppDomainSetup.cs.

◆ DisallowCodeDownload

bool System.AppDomainSetup.DisallowCodeDownload
getset

Gets or sets a value that indicates whether HTTP download of assemblies is allowed for an application domain.

Returns
true if HTTP download of assemblies is not allowed; false if it is allowed.

Definition at line 300 of file AppDomainSetup.cs.

◆ DisallowPublisherPolicy

bool System.AppDomainSetup.DisallowPublisherPolicy
getset

Gets or sets a value that indicates whether the <publisherPolicy> section of the configuration file is applied to an application domain.

Returns
true if the &lt;publisherPolicy&gt; section of the configuration file for an application domain is ignored; false if the declared publisher policy is honored.

Definition at line 256 of file AppDomainSetup.cs.

◆ DynamicBase

string System.AppDomainSetup.DynamicBase
getset

Gets or sets the base directory where the directory for dynamically generated files is located.

Returns
The directory where the P:System.AppDomain.DynamicDirectory is located. The return value of this property is different from the value assigned. See the Remarks section.
Exceptions
T:System.MemberAccessExceptionThis property cannot be set because the application name on the application domain is null.

Definition at line 224 of file AppDomainSetup.cs.

◆ LicenseFile

string System.AppDomainSetup.LicenseFile
getset

Gets or sets the location of the license file associated with this domain.

Returns
The location and name of the license file.

Definition at line 573 of file AppDomainSetup.cs.

◆ LoaderOptimization

LoaderOptimization System.AppDomainSetup.LoaderOptimization
getset

Specifies the optimization policy used to load an executable.

Returns
An enumerated constant that is used with the T:System.LoaderOptimizationAttribute.

Definition at line 588 of file AppDomainSetup.cs.

◆ PartialTrustVisibleAssemblies

string [] System.AppDomainSetup.PartialTrustVisibleAssemblies
getset

Gets or sets a list of assemblies marked with the F:System.Security.PartialTrustVisibilityLevel.NotVisibleByDefault flag that are made visible to partial-trust code running in a sandboxed application domain.

Returns
An array of partial assembly names, where each partial name consists of the simple assembly name and the public key.

Definition at line 136 of file AppDomainSetup.cs.

◆ PrivateBinPath

string System.AppDomainSetup.PrivateBinPath
getset

Gets or sets the list of directories under the application base directory that are probed for private assemblies.

Returns
A list of directory names separated by semicolons.

Definition at line 478 of file AppDomainSetup.cs.

◆ PrivateBinPathProbe

string System.AppDomainSetup.PrivateBinPathProbe
getset

Gets or sets a string value that includes or excludes P:System.AppDomainSetup.ApplicationBase from the search path for the application, and searches only P:System.AppDomainSetup.PrivateBinPath.

Returns
A null reference (Nothing in Visual Basic) to include the application base path when searching for assemblies; any non-null string value to exclude the path. The default value is null.

Definition at line 498 of file AppDomainSetup.cs.

◆ SandboxInterop

bool System.AppDomainSetup.SandboxInterop
getset

Gets or sets a value that indicates whether interface caching is disabled for interop calls in the application domain, so that a QueryInterface is performed on each call.

Returns
true if interface caching is disabled for interop calls in application domains created with the current T:System.AppDomainSetup object; otherwise, false.

Definition at line 615 of file AppDomainSetup.cs.

◆ ShadowCopyDirectories

string System.AppDomainSetup.ShadowCopyDirectories
getset

Gets or sets the names of the directories containing assemblies to be shadow copied.

Returns
A list of directory names separated by semicolons.

Definition at line 514 of file AppDomainSetup.cs.

◆ ShadowCopyFiles

string System.AppDomainSetup.ShadowCopyFiles
getset

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

Returns
The string value "true" to indicate that shadow copying is turned on; or "false" to indicate that shadow copying is turned off.

Definition at line 533 of file AppDomainSetup.cs.

◆ TargetFrameworkName

string System.AppDomainSetup.TargetFrameworkName
getset

Gets or sets a string that specifies the target version and profile of the .NET Framework for the application domain, in a format that can be parsed by the M:System.Runtime.Versioning.FrameworkName.::ctor(System.String) constructor.

Returns
The target version and profile of the .NET Framework.

Definition at line 196 of file AppDomainSetup.cs.


The documentation for this class was generated from the following file: