AppDomain.CreateDomain Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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).