Partager via


AppDomain.CreateDomain Méthode

Définition

Crée un domaine d’application.

Surcharges

Nom Description
CreateDomain(String, Evidence, String, String, Boolean, AppDomainInitializer, String[])

Crée un domaine d’application avec le nom donné, à l’aide de preuves, de chemin de base de l’application, d’un chemin de recherche relatif et d’un paramètre qui spécifie si une cliché instantané d’un assembly doit être chargée dans le domaine d’application. Spécifie une méthode de rappel appelée lorsque le domaine d’application est initialisé et un tableau d’arguments de chaîne pour passer la méthode de rappel.

CreateDomain(String, Evidence, String, String, Boolean)

Crée un domaine d’application avec le nom donné, à l’aide de preuves, de chemin de base de l’application, d’un chemin de recherche relatif et d’un paramètre qui spécifie si une cliché instantané d’un assembly doit être chargée dans le domaine d’application.

CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])

Crée un domaine d’application à l’aide du nom, de la preuve, des informations de configuration de domaine d’application, du jeu d’autorisations par défaut et du tableau d’assemblys entièrement approuvés.

CreateDomain(String, Evidence)

Crée un domaine d’application avec le nom donné à l’aide de la preuve fournie.

CreateDomain(String)
Obsolète.

Crée un domaine d’application avec le nom spécifié.

CreateDomain(String, Evidence, AppDomainSetup)

Crée un domaine d’application à l’aide des informations de configuration du nom, de la preuve et du domaine d’application spécifiés.

CreateDomain(String, Evidence, String, String, Boolean, AppDomainInitializer, String[])

Crée un domaine d’application avec le nom donné, à l’aide de preuves, de chemin de base de l’application, d’un chemin de recherche relatif et d’un paramètre qui spécifie si une cliché instantané d’un assembly doit être chargée dans le domaine d’application. Spécifie une méthode de rappel appelée lorsque le domaine d’application est initialisé et un tableau d’arguments de chaîne pour passer la méthode de rappel.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, System::String ^ appBasePath, System::String ^ appRelativeSearchPath, bool shadowCopyFiles, AppDomainInitializer ^ adInit, cli::array <System::String ^> ^ adInitArgs);
public static AppDomain CreateDomain(string friendlyName, System.Security.Policy.Evidence securityInfo, string appBasePath, string appRelativeSearchPath, bool shadowCopyFiles, AppDomainInitializer adInit, string[] adInitArgs);
static member CreateDomain : string * System.Security.Policy.Evidence * string * string * bool * AppDomainInitializer * string[] -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, appBasePath As String, appRelativeSearchPath As String, shadowCopyFiles As Boolean, adInit As AppDomainInitializer, adInitArgs As String()) As AppDomain

Paramètres

friendlyName
String

Nom convivial du domaine. Ce nom convivial peut être affiché dans les interfaces utilisateur pour identifier le domaine. Pour plus d’informations, consultez FriendlyName.

securityInfo
Evidence

Preuve qui établit l’identité du code qui s’exécute dans le domaine d’application. null Passez pour utiliser la preuve du domaine d’application actuel.

appBasePath
String

Répertoire de base utilisé par le programme de résolution d’assembly pour rechercher des assemblys. Pour plus d’informations, consultez BaseDirectory.

appRelativeSearchPath
String

Chemin relatif au répertoire de base où le programme de résolution d’assembly doit effectuer une sonde pour les assemblys privés. Pour plus d’informations, consultez RelativeSearchPath.

shadowCopyFiles
Boolean

true pour charger une cliché instantané d’un assembly dans le domaine d’application.

adInit
AppDomainInitializer

Délégué AppDomainInitializer qui représente une méthode de rappel à appeler lorsque le nouvel AppDomain objet est initialisé.

adInitArgs
String[]

Tableau d’arguments de chaîne à passer au rappel représenté par adInit, lorsque le nouvel AppDomain objet est initialisé.

Retours

Domaine d’application nouvellement créé.

Exceptions

friendlyName a la valeur null.

Remarques

La méthode représentée par adInit est exécutée dans le contexte du domaine d’application nouvellement créé.

S’il securityInfo n’est pas fourni, la preuve du domaine d’application actuel est utilisée.

Pour plus d’informations sur la copie d’ombres, consultez ShadowCopyFiles et les assemblys de cliché instantané.

Important

N’utilisez pas cette surcharge de méthode pour créer des domaines d’application en bac à sable (sandbox). À compter du .NET Framework 4, la preuve fournie pour securityInfo ne plus affecter le jeu d’octroi du domaine d’application. Utilisez la surcharge de CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) méthode pour créer des domaines d’application en bac à sable (sandbox).

S’applique à

CreateDomain(String, Evidence, String, String, Boolean)

Crée un domaine d’application avec le nom donné, à l’aide de preuves, de chemin de base de l’application, d’un chemin de recherche relatif et d’un paramètre qui spécifie si une cliché instantané d’un assembly doit être chargée dans le domaine d’application.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, System::String ^ appBasePath, System::String ^ appRelativeSearchPath, bool shadowCopyFiles);
public static AppDomain CreateDomain(string friendlyName, System.Security.Policy.Evidence securityInfo, string appBasePath, string appRelativeSearchPath, bool shadowCopyFiles);
static member CreateDomain : string * System.Security.Policy.Evidence * string * string * bool -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, appBasePath As String, appRelativeSearchPath As String, shadowCopyFiles As Boolean) As AppDomain

Paramètres

friendlyName
String

Nom convivial du domaine. Ce nom convivial peut être affiché dans les interfaces utilisateur pour identifier le domaine. Pour plus d’informations, consultez FriendlyName.

securityInfo
Evidence

Preuve qui établit l’identité du code qui s’exécute dans le domaine d’application. null Passez pour utiliser la preuve du domaine d’application actuel.

appBasePath
String

Répertoire de base utilisé par le programme de résolution d’assembly pour rechercher des assemblys. Pour plus d’informations, consultez BaseDirectory.

appRelativeSearchPath
String

Chemin relatif au répertoire de base où le programme de résolution d’assembly doit effectuer une sonde pour les assemblys privés. Pour plus d’informations, consultez RelativeSearchPath.

shadowCopyFiles
Boolean

Si true, une cliché instantané d’un assembly est chargée dans ce domaine d’application.

Retours

Domaine d’application nouvellement créé.

Exceptions

friendlyName a la valeur null.

Exemples

L’exemple suivant montre, en général, comment créer un domaine à l’aide de l’une CreateDomain des surcharges.

// Set up the AppDomainSetup
AppDomainSetup^ setup = gcnew AppDomainSetup;
setup->ApplicationBase = "(some directory)";
setup->ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence^ baseEvidence = AppDomain::CurrentDomain->Evidence;
Evidence^ evidence = gcnew Evidence( baseEvidence );
evidence->AddAssembly( "(some assembly)" );
evidence->AddHost( "(some host)" );

// Create the AppDomain
AppDomain^ newDomain = AppDomain::CreateDomain( "newDomain", evidence, setup );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
open System
open System.Security.Policy

// Set up the AppDomainSetup
let setup = AppDomainSetup()
setup.ApplicationBase <- "(some directory)"
setup.ConfigurationFile <- "(some file)"

// Set up the Evidence
let baseEvidence = AppDomain.CurrentDomain.Evidence
let evidence = Evidence baseEvidence
evidence.AddAssembly "(some assembly)"
evidence.AddHost "(some host)" 

// Create the AppDomain
let newDomain = AppDomain.CreateDomain("newDomain", evidence, setup)
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Remarques

S’il securityInfo n’est pas fourni, la preuve du domaine d’application actuel est utilisée.

Pour plus d’informations sur la copie d’ombres, consultez ShadowCopyFiles et les assemblys de cliché instantané.

Important

N’utilisez pas cette surcharge de méthode pour créer des domaines d’application en bac à sable (sandbox). À compter du .NET Framework 4, la preuve fournie pour securityInfo ne plus affecter le jeu d’octroi du domaine d’application. Utilisez la surcharge de CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) méthode pour créer des domaines d’application en bac à sable (sandbox).

S’applique à

CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])

Crée un domaine d’application à l’aide du nom, de la preuve, des informations de configuration de domaine d’application, du jeu d’autorisations par défaut et du tableau d’assemblys entièrement approuvés.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, AppDomainSetup ^ info, System::Security::PermissionSet ^ grantSet, ... cli::array <System::Security::Policy::StrongName ^> ^ fullTrustAssemblies);
public static AppDomain CreateDomain(string friendlyName, System.Security.Policy.Evidence securityInfo, AppDomainSetup info, System.Security.PermissionSet grantSet, params System.Security.Policy.StrongName[] fullTrustAssemblies);
static member CreateDomain : string * System.Security.Policy.Evidence * AppDomainSetup * System.Security.PermissionSet * System.Security.Policy.StrongName[] -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, info As AppDomainSetup, grantSet As PermissionSet, ParamArray fullTrustAssemblies As StrongName()) As AppDomain

Paramètres

friendlyName
String

Nom convivial du domaine. Ce nom convivial peut être affiché dans les interfaces utilisateur pour identifier le domaine. Pour plus d’informations, consultez la description de FriendlyName.

securityInfo
Evidence

Preuve qui établit l’identité du code qui s’exécute dans le domaine d’application. null Passez pour utiliser la preuve du domaine d’application actuel.

info
AppDomainSetup

Objet qui contient des informations d’initialisation de domaine d’application.

grantSet
PermissionSet

Jeu d’autorisations par défaut accordé à tous les assemblys chargés dans le nouveau domaine d’application qui n’ont pas d’octrois spécifiques.

fullTrustAssemblies
StrongName[]

Tableau de noms forts représentant des assemblys à considérer comme entièrement approuvés dans le nouveau domaine d’application.

Retours

Domaine d’application nouvellement créé.

Exceptions

friendlyName a la valeur null.

Le domaine d’application est null.

- ou -

La ApplicationBase propriété n’est pas définie sur l’objet AppDomainSetup fourni pour info.

Remarques

Vous devez définir la ApplicationBase propriété de l’objet AppDomainSetup que vous fournissez pour info. Sinon, une exception est levée.

S’il securityInfo n’est pas fourni, la preuve du domaine d’application actuel est utilisée.

Informations fournies et grantSetfullTrustAssemblies utilisées pour créer un ApplicationTrust objet pour le nouveau domaine d’application.

S’applique à

CreateDomain(String, Evidence)

Crée un domaine d’application avec le nom donné à l’aide de la preuve fournie.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo);
public static AppDomain CreateDomain(string friendlyName, System.Security.Policy.Evidence securityInfo);
static member CreateDomain : string * System.Security.Policy.Evidence -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence) As AppDomain

Paramètres

friendlyName
String

Nom convivial du domaine. Ce nom convivial peut être affiché dans les interfaces utilisateur pour identifier le domaine. Pour plus d’informations, consultez FriendlyName.

securityInfo
Evidence

Preuve qui établit l’identité du code qui s’exécute dans le domaine d’application. null Passez pour utiliser la preuve du domaine d’application actuel.

Retours

Domaine d’application nouvellement créé.

Exceptions

friendlyName a la valeur null.

Exemples

L’exemple suivant montre, en général, comment créer un domaine à l’aide de l’une CreateDomain des surcharges.

// Set up the AppDomainSetup
AppDomainSetup^ setup = gcnew AppDomainSetup;
setup->ApplicationBase = "(some directory)";
setup->ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence^ baseEvidence = AppDomain::CurrentDomain->Evidence;
Evidence^ evidence = gcnew Evidence( baseEvidence );
evidence->AddAssembly( "(some assembly)" );
evidence->AddHost( "(some host)" );

// Create the AppDomain
AppDomain^ newDomain = AppDomain::CreateDomain( "newDomain", evidence, setup );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
open System
open System.Security.Policy

// Set up the AppDomainSetup
let setup = AppDomainSetup()
setup.ApplicationBase <- "(some directory)"
setup.ConfigurationFile <- "(some file)"

// Set up the Evidence
let baseEvidence = AppDomain.CurrentDomain.Evidence
let evidence = Evidence baseEvidence
evidence.AddAssembly "(some assembly)"
evidence.AddHost "(some host)" 

// Create the AppDomain
let newDomain = AppDomain.CreateDomain("newDomain", evidence, setup)
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Remarques

Cette surcharge de méthode utilise les AppDomainSetup informations du domaine d’application par défaut.

S’il securityInfo n’est pas fourni, la preuve du domaine d’application actuel est utilisée.

Important

N’utilisez pas cette surcharge de méthode pour créer des domaines d’application en bac à sable (sandbox). À compter du .NET Framework 4, la preuve fournie pour securityInfo ne plus affecter le jeu d’octroi du domaine d’application. Utilisez la surcharge de CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) méthode pour créer des domaines d’application en bac à sable (sandbox).

S’applique à

CreateDomain(String)

Source:
AppDomain.cs
Source:
AppDomain.cs
Source:
AppDomain.cs
Source:
AppDomain.cs
Source:
AppDomain.cs

Attention

Creating and unloading AppDomains is not supported and throws an exception.

Crée un domaine d’application avec le nom spécifié.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName);
[System.Obsolete("Creating and unloading AppDomains is not supported and throws an exception.", DiagnosticId="SYSLIB0024", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static AppDomain CreateDomain(string friendlyName);
public static AppDomain CreateDomain(string friendlyName);
[<System.Obsolete("Creating and unloading AppDomains is not supported and throws an exception.", DiagnosticId="SYSLIB0024", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CreateDomain : string -> AppDomain
static member CreateDomain : string -> AppDomain
Public Shared Function CreateDomain (friendlyName As String) As AppDomain

Paramètres

friendlyName
String

Nom convivial du domaine.

Retours

Domaine d’application nouvellement créé.

Attributs

Exceptions

friendlyName a la valeur null.

.NET Core et .NET 5+ uniquement : dans tous les cas.

Exemples

L’exemple suivant montre, en général, comment créer un domaine à l’aide de l’une CreateDomain des surcharges.

// Set up the AppDomainSetup
AppDomainSetup^ setup = gcnew AppDomainSetup;
setup->ApplicationBase = "(some directory)";
setup->ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence^ baseEvidence = AppDomain::CurrentDomain->Evidence;
Evidence^ evidence = gcnew Evidence( baseEvidence );
evidence->AddAssembly( "(some assembly)" );
evidence->AddHost( "(some host)" );

// Create the AppDomain
AppDomain^ newDomain = AppDomain::CreateDomain( "newDomain", evidence, setup );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
open System
open System.Security.Policy

// Set up the AppDomainSetup
let setup = AppDomainSetup()
setup.ApplicationBase <- "(some directory)"
setup.ConfigurationFile <- "(some file)"

// Set up the Evidence
let baseEvidence = AppDomain.CurrentDomain.Evidence
let evidence = Evidence baseEvidence
evidence.AddAssembly "(some assembly)"
evidence.AddHost "(some host)" 

// Create the AppDomain
let newDomain = AppDomain.CreateDomain("newDomain", evidence, setup)
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Remarques

Le friendlyName paramètre est destiné à identifier le domaine d’une manière significative pour les humains. Cette chaîne doit être adaptée à l’affichage dans les interfaces utilisateur.

Cette surcharge de méthode utilise les AppDomainSetup informations du domaine d’application par défaut.

Voir aussi

S’applique à

CreateDomain(String, Evidence, AppDomainSetup)

Crée un domaine d’application à l’aide des informations de configuration du nom, de la preuve et du domaine d’application spécifiés.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName, System::Security::Policy::Evidence ^ securityInfo, AppDomainSetup ^ info);
public static AppDomain CreateDomain(string friendlyName, System.Security.Policy.Evidence securityInfo, AppDomainSetup info);
static member CreateDomain : string * System.Security.Policy.Evidence * AppDomainSetup -> AppDomain
Public Shared Function CreateDomain (friendlyName As String, securityInfo As Evidence, info As AppDomainSetup) As AppDomain

Paramètres

friendlyName
String

Nom convivial du domaine. Ce nom convivial peut être affiché dans les interfaces utilisateur pour identifier le domaine. Pour plus d’informations, consultez FriendlyName.

securityInfo
Evidence

Preuve qui établit l’identité du code qui s’exécute dans le domaine d’application. null Passez pour utiliser la preuve du domaine d’application actuel.

info
AppDomainSetup

Objet qui contient des informations d’initialisation de domaine d’application.

Retours

Domaine d’application nouvellement créé.

Exceptions

friendlyName a la valeur null.

Exemples

L’exemple suivant montre, en général, comment créer un domaine à l’aide de l’une CreateDomain des surcharges.

// Set up the AppDomainSetup
AppDomainSetup^ setup = gcnew AppDomainSetup;
setup->ApplicationBase = "(some directory)";
setup->ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence^ baseEvidence = AppDomain::CurrentDomain->Evidence;
Evidence^ evidence = gcnew Evidence( baseEvidence );
evidence->AddAssembly( "(some assembly)" );
evidence->AddHost( "(some host)" );

// Create the AppDomain
AppDomain^ newDomain = AppDomain::CreateDomain( "newDomain", evidence, setup );
// Set up the AppDomainSetup
AppDomainSetup setup = new AppDomainSetup();
setup.ApplicationBase = "(some directory)";
setup.ConfigurationFile = "(some file)";

// Set up the Evidence
Evidence baseEvidence = AppDomain.CurrentDomain.Evidence;
Evidence evidence = new Evidence(baseEvidence);
evidence.AddAssembly("(some assembly)");
evidence.AddHost("(some host)");

// Create the AppDomain
AppDomain newDomain = AppDomain.CreateDomain("newDomain", evidence, setup);
open System
open System.Security.Policy

// Set up the AppDomainSetup
let setup = AppDomainSetup()
setup.ApplicationBase <- "(some directory)"
setup.ConfigurationFile <- "(some file)"

// Set up the Evidence
let baseEvidence = AppDomain.CurrentDomain.Evidence
let evidence = Evidence baseEvidence
evidence.AddAssembly "(some assembly)"
evidence.AddHost "(some host)" 

// Create the AppDomain
let newDomain = AppDomain.CreateDomain("newDomain", evidence, setup)
' Set up the AppDomainSetup
Dim setup As New AppDomainSetup()
setup.ApplicationBase = "(some directory)"
setup.ConfigurationFile = "(some file)"

' Set up the Evidence
Dim baseEvidence As Evidence = AppDomain.CurrentDomain.Evidence
Dim evidence As New Evidence(baseEvidence)
evidence.AddAssembly("(some assembly)")
evidence.AddHost("(some host)")

' Create the AppDomain
Dim newDomain As AppDomain = AppDomain.CreateDomain("newDomain", evidence, setup)

Remarques

Si info elle n’est pas fournie, cette surcharge de méthode utilise les AppDomainSetup informations du domaine d’application par défaut.

S’il securityInfo n’est pas fourni, la preuve du domaine d’application actuel est utilisée.

Important

N’utilisez pas cette surcharge de méthode pour créer des domaines d’application en bac à sable (sandbox). À compter du .NET Framework 4, la preuve fournie pour securityInfo ne plus affecter le jeu d’octroi du domaine d’application. Utilisez la surcharge de CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) méthode pour créer des domaines d’application en bac à sable (sandbox).

S’applique à