AppDomain.CreateDomain Methode

Definition

Erstellt eine neue Anwendungsdomäne.Creates a new application domain.

Überlädt

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

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen unter Verwendung der Beweise, des Anwendungsbasispfads, des relativen Suchpfads und eines Parameters, der angibt, ob eine Schattenkopie einer Assembly in die Anwendungsdomäne geladen werden soll.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain. Gibt eine Rückrufmethode an, die beim Initialisieren der Anwendungsdomäne aufgerufen wird, und ein Array von Zeichenfolgenargumenten, die an die Rückrufmethode übergeben werden sollen.Specifies a callback method that is invoked when the application domain is initialized, and an array of string arguments to pass the callback method.

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

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen unter Verwendung der Beweise, des Anwendungsbasispfads, des relativen Suchpfads und eines Parameters, der angibt, ob eine Schattenkopie einer Assembly in die Anwendungsdomäne geladen werden soll.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain.

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

Erstellt eine neue Anwendungsdomäne mit angegebenem Namen, Beweis, Anwendungsdomänen-Setupinformationen, Standardberechtigungssatz und Array vollständig vertrauenswürdiger Assemblys.Creates a new application domain using the specified name, evidence, application domain setup information, default permission set, and array of fully trusted assemblies.

CreateDomain(String, Evidence)

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen und den bereitgestellten Beweisen.Creates a new application domain with the given name using the supplied evidence.

CreateDomain(String)

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen.Creates a new application domain with the specified name.

CreateDomain(String, Evidence, AppDomainSetup)

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen, den angegebenen Beweisen und Anwendungsdomänen-Setupinformationen.Creates a new application domain using the specified name, evidence, and application domain setup information.

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

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen unter Verwendung der Beweise, des Anwendungsbasispfads, des relativen Suchpfads und eines Parameters, der angibt, ob eine Schattenkopie einer Assembly in die Anwendungsdomäne geladen werden soll.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain. Gibt eine Rückrufmethode an, die beim Initialisieren der Anwendungsdomäne aufgerufen wird, und ein Array von Zeichenfolgenargumenten, die an die Rückrufmethode übergeben werden sollen.Specifies a callback method that is invoked when the application domain is initialized, and an array of string arguments to pass the callback method.

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

Parameter

friendlyName
String

Der angezeigte Name der Domäne.The friendly name of the domain. Dieser aussagekräftige Name zur Kennzeichnung der Domäne kann auf Benutzeroberflächen angezeigt werden.This friendly name can be displayed in user interfaces to identify the domain. Weitere Informationen finden Sie unter FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence

Ein Beweis für die Identität des Codes, der in der Anwendungsdomäne ausgeführt wird.Evidence that establishes the identity of the code that runs in the application domain. Übergeben Sie null, um den Beweis der aktuellen Anwendungsdomäne zu verwenden.Pass null to use the evidence of the current application domain.

appBasePath
String

Das Basisverzeichnis, das der Assemblyresolver für die Suche nach Assemblys verwendet.The base directory that the assembly resolver uses to probe for assemblies. Weitere Informationen finden Sie unter BaseDirectory.For more information, see BaseDirectory.

appRelativeSearchPath
String

Der Pfad, in dem der Assemblyresolver nach privaten Assemblys suchen soll, mit einer relativen Angabe zum Basisverzeichnis.The path relative to the base directory where the assembly resolver should probe for private assemblies. Weitere Informationen finden Sie unter RelativeSearchPath.For more information, see RelativeSearchPath.

shadowCopyFiles
Boolean

true, um eine Schattenkopie einer Assembly in die Anwendungsdomäne zu laden.true to load a shadow copy of an assembly into the application domain.

adInit
AppDomainInitializer

Ein AppDomainInitializer-Delegat, der eine Rückrufmethode darstellt, die beim Initialisieren des neuen AppDomain-Objekts aufgerufen werden soll.An AppDomainInitializer delegate that represents a callback method to invoke when the new AppDomain object is initialized.

adInitArgs
String[]

Ein Array von Zeichenfolgenargumenten, das an die durch adInit dargestellte Rückrufmethode übergeben werden soll, wenn das neue AppDomain-Objekt initialisiert wird.An array of string arguments to be passed to the callback represented by adInit, when the new AppDomain object is initialized.

Gibt zurück

Die neu erstellte Anwendungsdomäne.The newly created application domain.

Ausnahmen

friendlyName ist nullfriendlyName is null.

Hinweise

Die durch adInit dargestellte Methode wird im Kontext der neu erstellten Anwendungsdomäne ausgeführt.The method represented by adInit is executed in the context of the newly created application domain.

Wenn securityInfo nicht angegeben wird, wird der Beweis der aktuellen Anwendungsdomäne verwendet.If securityInfo is not supplied, the evidence from the current application domain is used.

Weitere Informationen zum Kopieren von Schatten Informationen finden Sie unter ShadowCopyFiles und schattenkopieassemblys.For more information about shadow copying, see ShadowCopyFiles and Shadow Copying Assemblies.

Wichtig

Verwenden Sie diese Methoden Überladung nicht zum Erstellen von Sandbox-Anwendungs Domänen.Do not use this method overload to create sandboxed application domains. Beginnend mit dem .NET Framework 4.NET Framework 4wirkt sich der Beweis, der für securityInfo bereitgestellt wird, nicht mehr auf den Berechtigungs Satz der Anwendungsdomäne aus.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Verwenden Sie die CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])-Methoden Überladung, um Sandbox-Anwendungs Domänen zu erstellen.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

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

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen unter Verwendung der Beweise, des Anwendungsbasispfads, des relativen Suchpfads und eines Parameters, der angibt, ob eine Schattenkopie einer Assembly in die Anwendungsdomäne geladen werden soll.Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain.

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

Parameter

friendlyName
String

Der angezeigte Name der Domäne.The friendly name of the domain. Dieser aussagekräftige Name zur Kennzeichnung der Domäne kann auf Benutzeroberflächen angezeigt werden.This friendly name can be displayed in user interfaces to identify the domain. Weitere Informationen finden Sie unter FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence

Ein Beweis für die Identität des Codes, der in der Anwendungsdomäne ausgeführt wird.Evidence that establishes the identity of the code that runs in the application domain. Übergeben Sie null, um den Beweis der aktuellen Anwendungsdomäne zu verwenden.Pass null to use the evidence of the current application domain.

appBasePath
String

Das Basisverzeichnis, das der Assemblyresolver für die Suche nach Assemblys verwendet.The base directory that the assembly resolver uses to probe for assemblies. Weitere Informationen finden Sie unter BaseDirectory.For more information, see BaseDirectory.

appRelativeSearchPath
String

Der Pfad, in dem der Assemblyresolver nach privaten Assemblys suchen soll, mit einer relativen Angabe zum Basisverzeichnis.The path relative to the base directory where the assembly resolver should probe for private assemblies. Weitere Informationen finden Sie unter RelativeSearchPath.For more information, see RelativeSearchPath.

shadowCopyFiles
Boolean

Wenn true, wird eine Spiegelung einer Assembly in diese Anwendungsdomäne geladen.If true, a shadow copy of an assembly is loaded into this application domain.

Gibt zurück

Die neu erstellte Anwendungsdomäne.The newly created application domain.

Ausnahmen

friendlyName ist nullfriendlyName is null.

Beispiele

Im folgenden Beispiel wird im allgemeinen veranschaulicht, wie eine Domäne mithilfe einer der-CreateDomain Überladungen erstellt wird.The following sample demonstrates, in general, how to create a domain using one of the CreateDomain overloads.

// 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);
' 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)

Hinweise

Wenn securityInfo nicht angegeben wird, wird der Beweis der aktuellen Anwendungsdomäne verwendet.If securityInfo is not supplied, the evidence from the current application domain is used.

Weitere Informationen zum Kopieren von Schatten Informationen finden Sie unter ShadowCopyFiles und schattenkopieassemblys.For more information about shadow copying, see ShadowCopyFiles and Shadow Copying Assemblies.

Wichtig

Verwenden Sie diese Methoden Überladung nicht zum Erstellen von Sandbox-Anwendungs Domänen.Do not use this method overload to create sandboxed application domains. Beginnend mit dem .NET Framework 4.NET Framework 4wirkt sich der Beweis, der für securityInfo bereitgestellt wird, nicht mehr auf den Berechtigungs Satz der Anwendungsdomäne aus.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Verwenden Sie die CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])-Methoden Überladung, um Sandbox-Anwendungs Domänen zu erstellen.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

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

Erstellt eine neue Anwendungsdomäne mit angegebenem Namen, Beweis, Anwendungsdomänen-Setupinformationen, Standardberechtigungssatz und Array vollständig vertrauenswürdiger Assemblys.Creates a new application domain using the specified name, evidence, application domain setup information, default permission set, and array of fully trusted assemblies.

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

Parameter

friendlyName
String

Der angezeigte Name der Domäne.The friendly name of the domain. Dieser aussagekräftige Name zur Kennzeichnung der Domäne kann auf Benutzeroberflächen angezeigt werden.This friendly name can be displayed in user interfaces to identify the domain. Weitere Informationen finden Sie in der Beschreibung von FriendlyName.For more information, see the description of FriendlyName.

securityInfo
Evidence

Ein Beweis für die Identität des Codes, der in der Anwendungsdomäne ausgeführt wird.Evidence that establishes the identity of the code that runs in the application domain. Übergeben Sie null, um den Beweis der aktuellen Anwendungsdomäne zu verwenden.Pass null to use the evidence of the current application domain.

info
AppDomainSetup

Ein Objekt, das Initialisierungsinformationen für die Anwendungsdomäne enthält.An object that contains application domain initialization information.

grantSet
PermissionSet

Ein Standardberechtigungssatz, der allen Assemblys gewährt wird, die in die neue Anwendungsdomäne geladen werden und über keine speziellen Berechtigungen verfügen.A default permission set that is granted to all assemblies loaded into the new application domain that do not have specific grants.

fullTrustAssemblies
StrongName[]

Ein Array von starken Namen, die Assemblys darstellen und in der neuen Anwendungsdomäne als vollständig vertrauenswürdig betrachtet werden sollen.An array of strong names representing assemblies to be considered fully trusted in the new application domain.

Gibt zurück

Die neu erstellte Anwendungsdomäne.The newly created application domain.

Ausnahmen

friendlyName ist nullfriendlyName is null.

Die Anwendungsdomäne ist null.The application domain is null.

- oder --or- Die ApplicationBase-Eigenschaft ist nicht für das AppDomainSetup-Objekt festgelegt, das für info bereitgestellt ist.The ApplicationBase property is not set on the AppDomainSetup object that is supplied for info.

Hinweise

Sie müssen die ApplicationBase-Eigenschaft des AppDomainSetup-Objekts festlegen, das Sie für infobereitstellen.You must set the ApplicationBase property of the AppDomainSetup object that you supply for info. Andernfalls wird eine Ausnahme ausgelöst.Otherwise, an exception is thrown.

Wenn securityInfo nicht angegeben wird, wird der Beweis der aktuellen Anwendungsdomäne verwendet.If securityInfo is not supplied, the evidence from the current application domain is used.

Die Informationen, die für grantSet und fullTrustAssemblies bereitgestellt werden, werden verwendet, um ein ApplicationTrust-Objekt für die neue Anwendungsdomäne zu erstellen.The information provided for grantSet and fullTrustAssemblies is used to create an ApplicationTrust object for the new application domain.

CreateDomain(String, Evidence)

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen und den bereitgestellten Beweisen.Creates a new application domain with the given name using the supplied evidence.

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

Parameter

friendlyName
String

Der angezeigte Name der Domäne.The friendly name of the domain. Dieser aussagekräftige Name zur Kennzeichnung der Domäne kann auf Benutzeroberflächen angezeigt werden.This friendly name can be displayed in user interfaces to identify the domain. Weitere Informationen finden Sie unter FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence

Ein Beweis für die Identität des Codes, der in der Anwendungsdomäne ausgeführt wird.Evidence that establishes the identity of the code that runs in the application domain. Übergeben Sie null, um den Beweis der aktuellen Anwendungsdomäne zu verwenden.Pass null to use the evidence of the current application domain.

Gibt zurück

Die neu erstellte Anwendungsdomäne.The newly created application domain.

Ausnahmen

friendlyName ist nullfriendlyName is null.

Beispiele

Im folgenden Beispiel wird im allgemeinen veranschaulicht, wie eine Domäne mithilfe einer der-CreateDomain Überladungen erstellt wird.The following sample demonstrates, in general, how to create a domain using one of the CreateDomain overloads.

// 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);
' 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)

Hinweise

Diese Methoden Überladung verwendet die AppDomainSetup Informationen aus der Standard Anwendungsdomäne.This method overload uses the AppDomainSetup information from the default application domain.

Wenn securityInfo nicht angegeben wird, wird der Beweis der aktuellen Anwendungsdomäne verwendet.If securityInfo is not supplied, the evidence from the current application domain is used.

Wichtig

Verwenden Sie diese Methoden Überladung nicht zum Erstellen von Sandbox-Anwendungs Domänen.Do not use this method overload to create sandboxed application domains. Beginnend mit dem .NET Framework 4.NET Framework 4wirkt sich der Beweis, der für securityInfo bereitgestellt wird, nicht mehr auf den Berechtigungs Satz der Anwendungsdomäne aus.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Verwenden Sie die CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])-Methoden Überladung, um Sandbox-Anwendungs Domänen zu erstellen.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

CreateDomain(String)

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen.Creates a new application domain with the specified name.

public:
 static AppDomain ^ CreateDomain(System::String ^ friendlyName);
public static AppDomain CreateDomain (string friendlyName);
static member CreateDomain : string -> AppDomain
Public Shared Function CreateDomain (friendlyName As String) As AppDomain

Parameter

friendlyName
String

Der angezeigte Name der Domäne.The friendly name of the domain.

Gibt zurück

Die neu erstellte Anwendungsdomäne.The newly created application domain.

Ausnahmen

friendlyName ist nullfriendlyName is null.

Diese Methode wird auf .NET Core nicht unterstützt.Method not supported on .NET Core.

Beispiele

Im folgenden Beispiel wird im allgemeinen veranschaulicht, wie eine Domäne mithilfe einer der-CreateDomain Überladungen erstellt wird.The following sample demonstrates, in general, how to create a domain using one of the CreateDomain overloads.

// 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);
' 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)

Hinweise

Der friendlyName-Parameter dient zur Identifizierung der Domäne auf eine Weise, die für Menschen von Bedeutung ist.The friendlyName parameter is intended to identify the domain in a manner that is meaningful to humans. Diese Zeichenfolge sollte für die Anzeige in Benutzeroberflächen geeignet sein.This string should be suitable for display in user interfaces.

Diese Methoden Überladung verwendet die AppDomainSetup Informationen aus der Standard Anwendungsdomäne.This method overload uses the AppDomainSetup information from the default application domain.

Siehe auch

CreateDomain(String, Evidence, AppDomainSetup)

Erstellt eine neue Anwendungsdomäne mit dem angegebenen Namen, den angegebenen Beweisen und Anwendungsdomänen-Setupinformationen.Creates a new application domain using the specified name, evidence, and application domain setup information.

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

Parameter

friendlyName
String

Der angezeigte Name der Domäne.The friendly name of the domain. Dieser aussagekräftige Name zur Kennzeichnung der Domäne kann auf Benutzeroberflächen angezeigt werden.This friendly name can be displayed in user interfaces to identify the domain. Weitere Informationen finden Sie unter FriendlyName.For more information, see FriendlyName.

securityInfo
Evidence

Ein Beweis für die Identität des Codes, der in der Anwendungsdomäne ausgeführt wird.Evidence that establishes the identity of the code that runs in the application domain. Übergeben Sie null, um den Beweis der aktuellen Anwendungsdomäne zu verwenden.Pass null to use the evidence of the current application domain.

info
AppDomainSetup

Ein Objekt, das Initialisierungsinformationen für die Anwendungsdomäne enthält.An object that contains application domain initialization information.

Gibt zurück

Die neu erstellte Anwendungsdomäne.The newly created application domain.

Ausnahmen

friendlyName ist nullfriendlyName is null.

Beispiele

Im folgenden Beispiel wird im allgemeinen veranschaulicht, wie eine Domäne mithilfe einer der-CreateDomain Überladungen erstellt wird.The following sample demonstrates, in general, how to create a domain using one of the CreateDomain overloads.

// 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);
' 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)

Hinweise

Wenn info nicht angegeben wird, verwendet diese Methoden Überladung die AppDomainSetup Informationen aus der Standard Anwendungsdomäne.If info is not supplied, this method overload uses the AppDomainSetup information from the default application domain.

Wenn securityInfo nicht angegeben wird, wird der Beweis der aktuellen Anwendungsdomäne verwendet.If securityInfo is not supplied, the evidence from the current application domain is used.

Wichtig

Verwenden Sie diese Methoden Überladung nicht zum Erstellen von Sandbox-Anwendungs Domänen.Do not use this method overload to create sandboxed application domains. Beginnend mit dem .NET Framework 4.NET Framework 4wirkt sich der Beweis, der für securityInfo bereitgestellt wird, nicht mehr auf den Berechtigungs Satz der Anwendungsdomäne aus.Beginning with the .NET Framework 4.NET Framework 4, the evidence that is supplied for securityInfo no longer affects the grant set of the application domain. Verwenden Sie die CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[])-Methoden Überladung, um Sandbox-Anwendungs Domänen zu erstellen.Use the CreateDomain(String, Evidence, AppDomainSetup, PermissionSet, StrongName[]) method overload to create sandboxed application domains.

Gilt für: