Export (0) Print
Expand All

AppDomainSetup::AppDomainInitializer Property

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

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

property AppDomainInitializer^ AppDomainInitializer {
	AppDomainInitializer^ get ();
	void set (AppDomainInitializer^ value);

Property Value

Type: System::AppDomainInitializer
A delegate that represents a callback method that is invoked when the application domain is initialized.

To pass information to the callback method, assign an array of strings to the AppDomainInitializerArguments property. The array is passed to the callback method each time an AppDomain is initialized.

The callback method is executed in the context of the newly created application domain.

The following example creates a child application domain named ChildDomain, using an AppDomainSetup object and evidence from the default application domain. The AppDomainInitializer property is set to the callback method AppDomainInit, which is invoked when the child domain is initialized. The arguments for the callback method are placed in an array of strings, which is assigned to the AppDomainInitializerArguments property. When the child domain is created, the callback method simply prints the strings.

using namespace System;
using namespace System::Security::Policy;

public ref class AppDomainInitializerExample
    // The callback method invoked when the child application domain is
    // initialized. The method simply displays the arguments that were
    // passed to it.
    static void AppDomainInit(array<String^>^ args)
        Console::WriteLine("AppDomain \"{0}\" is initialized with these " +
            "arguments:", AppDomain::CurrentDomain->FriendlyName);
        for each (String^ arg in args)
            Console::WriteLine("    {0}", arg);

int main()
    // Get a reference to the default application domain.
    AppDomain^ currentDomain = AppDomain::CurrentDomain;

    // Create the AppDomainSetup that will be used to set up the child
    // AppDomain.
    AppDomainSetup^ domainSetup = gcnew AppDomainSetup();

    // Use the evidence from the default application domain to
    // create evidence for the child application domain.
    Evidence^ evidence = gcnew Evidence(currentDomain->Evidence);

    // Create an AppDomainInitializer delegate that represents the
    // callback method, AppDomainInit. Assign this delegate to the
    // AppDomainInitializer property of the AppDomainSetup object.
    AppDomainInitializer^ domainInitializer =
        gcnew AppDomainInitializer(AppDomainInitializerExample::AppDomainInit);
    domainSetup->AppDomainInitializer = domainInitializer;

    // Create an array of strings to pass as arguments to the callback
    // method. Assign the array to the AppDomainInitializerArguments
    // property.
    array<String^>^ initialArguments = {"String1", "String2"};
    domainSetup->AppDomainInitializerArguments = initialArguments;

    // Create a child application domain named "ChildDomain", using
    // the evidence and the AppDomainSetup object.
    AppDomain^ appDomain = AppDomain::CreateDomain("ChildDomain",
        evidence, domainSetup);

    Console::WriteLine("Press the Enter key to exit the example program.");

/* This code example produces the following output:

AppDomain "ChildDomain" is initialized with these arguments:

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

© 2015 Microsoft