AppDomain.CreateInstanceFrom Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Vytvoří novou instanci určeného typu, který je definován v určeném souboru sestavení.

Přetížení

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Vytvoří novou instanci určeného typu definovaného v určeném souboru sestavení.
CreateInstanceFrom(String, String, Object[])	Vytvoří novou instanci určeného typu definovaného v určeném souboru sestavení.
CreateInstanceFrom(String, String)	Vytvoří novou instanci určeného typu definovaného v určeném souboru sestavení.

CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Zdroj:

AppDomain.cs

Vytvoří novou instanci určeného typu definovaného v určeném souboru sestavení.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, bool ignoreCase, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture, cli::array <System::Object ^> ^ activationAttributes);

public System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, object?[]? args, System.Globalization.CultureInfo? culture, object?[]? activationAttributes);

member this.CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Function CreateInstanceFrom (assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object()) As ObjectHandle

Parametry

assemblyFile

String

Název souboru (včetně cesty), který obsahuje sestavení s definicí požadovaného typu. Sestavení se načte pomocí LoadFrom(String) metody .

typeName

String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale ne sestavení, jak je vráceno FullName vlastností.

ignoreCase

Boolean

Logická hodnota označující, zda se při vyhledávání mají rozlišovat malá a velká písmena.

bindingAttr

BindingFlags

Kombinace nulových nebo více bitových příznaků, které ovlivňují hledání konstruktoru typeName . Pokud bindingAttr je hodnota nula, provede se vyhledávání veřejných konstruktorů s rozlišováním velkých a malých písmen.

binder

Binder

Objekt, který umožňuje vazbu, vynucování typů argumentů, vyvolání členů a načtení MemberInfo objektů prostřednictvím reflexe. Pokud binder je hodnota null, použije se výchozí pořadač.

args

Object[]

Argumenty předané konstruktoru. U tohoto pole argumentů musí odpovídat číslo, pořadí a typ parametrů volanému konstruktoru. Pokud je preferován konstruktor bez parametrů, args musí být prázdné pole nebo null.

culture

CultureInfo

Informace specifické pro jazykovou verzi, které řídí donucování k formálním args typům deklarovaným typeName pro konstruktor. Pokud culture je null, použije se CultureInfo pro aktuální vlákno.

activationAttributes

Object[]

Pole jednoho nebo několika atributů, které se mohou podílet na aktivaci. Obvykle se jedná o pole obsahující jeden UrlAttribute objekt, který určuje adresu URL, která je nutná k aktivaci vzdáleného objektu.

Tento parametr souvisí s objekty aktivovanými klientem. Aktivace klienta je starší technologie, která se zachovává kvůli zpětné kompatibilitě, ale nedoporučuje se pro nový vývoj. Distribuované aplikace by místo toho měly používat Windows Communication Foundation.

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci, nebo null pokud typeName nebyl nalezen. Přístup k reálnému objektu lze zajistit pouze pomocí nezabalené návratové hodnoty.

Výjimky

ArgumentNullException

assemblyFile je null.

-nebo-

typeName je null.

NotSupportedException

Volající nemůže zadat aktivační atributy pro objekt, který nedědí z MarshalByRefObject.

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

FileNotFoundException

assemblyFile nebyl nalezen.

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

MissingMethodException

Nebyl nalezen žádný odpovídající veřejný konstruktor.

MethodAccessException

Volající nemá dostatečná oprávnění pro volání tohoto konstruktoru.

BadImageFormatException

assemblyFile není platné sestavení pro aktuálně načtený modul runtime.

FileLoadException

Sestavení nebo modul byly zavedeny dvakrát se dvěma různými legitimacemi.

NullReferenceException

Tato instance je null.

Poznámky

Další informace najdete v Activator.CreateInstanceFrom metodě.

Pokud se CreateInstanceFrom metoda použije k vytvoření instance v cílové doméně aplikace, kromě domény aplikace, ze které je volání provedeno, sestavení se načte v cílové doméně aplikace. Pokud je však v doméně aplikace instance nezabalená, použití nezabalené instance může v určitých případech způsobit zavedení sestavení do domény volající aplikace. Například po rozbalení instance mohou být vyžadovány její informace o typech, které jsou nutné pro volání obsažených metod pozdní vazbou. Po zavedení sestavení do domény volající aplikace může dojít k výjimkám.

• Pokud byla do domény volající aplikace dříve načtena jiná verze stejného sestavení nebo pokud se cesta načítání volající domény aplikace liší od cílové domény aplikace, může dojít k výjimkám, jako MissingMethodException je například.

• Pokud doména volající aplikace provádí dřívější volání typu instance, InvalidCastException může být vyvolán při pokusu o přetypování instance.

Viz také

• CreateInstanceFrom(String, String)

CreateInstanceFrom(String, String, Object[])

Zdroj:

AppDomain.cs

Vytvoří novou instanci určeného typu definovaného v určeném souboru sestavení.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Object ^> ^ activationAttributes);

public System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName, object?[]? activationAttributes);

member this.CreateInstanceFrom : string * string * obj[] -> System.Runtime.Remoting.ObjectHandle

Public Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandle

Parametry

assemblyFile

String

Název souboru (včetně cesty), který obsahuje sestavení s definicí požadovaného typu. Sestavení se načte pomocí LoadFrom(String) metody .

typeName

String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale ne sestavení, jak je vráceno FullName vlastností.

activationAttributes

Object[]

Pole jednoho nebo několika atributů, které se mohou podílet na aktivaci. Obvykle se jedná o pole obsahující jeden UrlAttribute objekt, který určuje adresu URL, která je nutná k aktivaci vzdáleného objektu.

Tento parametr souvisí s objekty aktivovanými klientem. Aktivace klienta je starší technologie, která se zachovává kvůli zpětné kompatibilitě, ale nedoporučuje se pro nový vývoj. Distribuované aplikace by místo toho měly používat Windows Communication Foundation.

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci, nebo null pokud typeName nebyl nalezen. Přístup k reálnému objektu lze zajistit pouze pomocí nezabalené návratové hodnoty.

Výjimky

ArgumentNullException

assemblyFile je null.

FileNotFoundException

assemblyFile nebyl nalezen.

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

MethodAccessException

Volající nemá dostatečná oprávnění pro volání tohoto konstruktoru.

MissingMethodException

Nebyl nalezen žádný odpovídající veřejný konstruktor.

NotSupportedException

Volající nemůže zadat aktivační atributy pro objekt, který nedědí z MarshalByRefObject.

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

BadImageFormatException

assemblyFile není platné sestavení pro aktuálně načtený modul runtime.

FileLoadException

Sestavení nebo modul byly zavedeny dvakrát se dvěma různými legitimacemi.

NullReferenceException

Tato instance je null.

Poznámky

Vyvolá se konstruktor bez parametrů pro typeName .

Další informace o této metodě najdete v Activator.CreateInstanceFrom metodě.

Pokud se CreateInstanceFrom metoda použije k vytvoření instance v cílové doméně aplikace, kromě domény aplikace, ze které je volání provedeno, sestavení se načte v cílové doméně aplikace. Pokud je však v doméně aplikace instance nezabalená, použití nezabalené instance může v určitých případech způsobit zavedení sestavení do domény volající aplikace. Například po rozbalení instance mohou být vyžadovány její informace o typech, které jsou nutné pro volání obsažených metod pozdní vazbou. Po zavedení sestavení do domény volající aplikace může dojít k výjimkám.

• Pokud byla do domény volající aplikace dříve načtena jiná verze stejného sestavení nebo pokud se cesta načítání volající domény aplikace liší od cílové domény aplikace, může dojít k výjimkám, jako MissingMethodException je například.

• Pokud doména volající aplikace provádí dřívější volání typu instance, InvalidCastException může být vyvolán při pokusu o přetypování instance.

Viz také

• CreateInstanceFrom(String, String)

CreateInstanceFrom(String, String)

Zdroj:

AppDomain.cs

Vytvoří novou instanci určeného typu definovaného v určeném souboru sestavení.

public:
 System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName);

public System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom (string assemblyFile, string typeName);

member this.CreateInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle

Public Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandle

Parametry

assemblyFile

String

Název souboru (včetně cesty), který obsahuje sestavení s definicí požadovaného typu. Sestavení se načte pomocí LoadFrom(String) metody .

typeName

String

Plně kvalifikovaný název požadovaného typu, včetně oboru názvů, ale ne sestavení, jak je vráceno FullName vlastností.

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci, nebo null pokud typeName nebyl nalezen. Přístup k reálnému objektu lze zajistit pouze pomocí nezabalené návratové hodnoty.

Výjimky

ArgumentNullException

assemblyFile je null.

-nebo-

typeName je null.

FileNotFoundException

assemblyFile nebyl nalezen.

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

AppDomainUnloadedException

Dojde k pokusu o operaci na uvolněné doméně aplikace.

MissingMethodException

Nebyl nalezen žádný veřejný konstruktor bez parametrů.

MethodAccessException

Volající nemá dostatečná oprávnění pro volání tohoto konstruktoru.

BadImageFormatException

assemblyFile není platné sestavení pro aktuálně načtený modul runtime.

FileLoadException

Sestavení nebo modul byly zavedeny dvakrát se dvěma různými legitimacemi.

NullReferenceException

Tato instance je null.

Příklady

Následující příklad ukazuje, jak použít CreateInstanceFrom(String, String) přetížení metody k vytvoření instance objektu v cílové doméně aplikace a volání jeho metod.

Příklad definuje MarshalableExample třídu, která může být zařazována napříč hranicemi domény aplikace. Příklad sestaví cestu k aktuálně spuštěné sestavení, vytvoří cílovou doménu aplikace a pomocí CreateInstanceFrom(String, String) přetížení metody načte ukázkové sestavení do cílové domény aplikace a vytvoří instanci MarshalableExample.

Poznámka

Cesta je v tomto příkladu absolutní, ale relativní cesta by také fungovala, protože Assembly.LoadFrom metoda se používá k načtení sestavení.

Po rozbalení popisovače objektu ukazuje příklad tři způsoby použití objektu v cílové doméně aplikace:

• Vyvolání metody s pozdní vazbou pomocí reflexe To vyžaduje informace o typu, což způsobí, že sestavení se načte do domény aplikace volajícího. (V tomto příkladu je již načten.)

• Přetypování objektu do rozhraní známého volajícímu i volaným. Pokud je rozhraní definováno ve volajícím sestavení nebo ve třetím sestavení, na které odkazuje volající i volaný, není volané sestavení načteno do domény aplikace volajícího.

• Použití objektu přímo, pokud je jeho typ známý volajícímu. Sestavení musí být načteno do domény aplikace volajícího.

Dalším způsobem, jak se vyhnout načtení volaného sestavení do domény aplikace volajícího, je, že volající odvozuje z MarshalByRefObject třídy a definuje metodu, která může být spuštěna v cílové doméně aplikace. Tato metoda může použít reflexi ke zkoumání cílového sestavení, protože cílové sestavení je již načteno do domény cílové aplikace. Podívejte se na příklad DynamicDirectory vlastnosti.

using namespace System;

public interface class ITest
{
    void Test(String^ greeting);
};

public ref class MarshalableExample : MarshalByRefObject, ITest
{
public:
    virtual void Test(String^ greeting)
    {
        Console::WriteLine("{0} from '{1}'!", greeting,
            AppDomain::CurrentDomain->FriendlyName);
    }
};

void main()
{
    // Construct a path to the current assembly.
    String^ assemblyPath = Environment::CurrentDirectory + "\\" +
        MarshalableExample::typeid->Assembly->GetName()->Name + ".exe";

    AppDomain^ ad = AppDomain::CreateDomain("MyDomain");
 
    System::Runtime::Remoting::ObjectHandle^ oh = 
        ad->CreateInstanceFrom(assemblyPath, "MarshalableExample");

    Object^ obj = oh->Unwrap();


    // Three ways to use the newly created object, depending on how
    // much is known about the type: Late bound, early bound through 
    // a mutually known interface, or early binding of a known type.
    //
    obj->GetType()->InvokeMember("Test", 
        System::Reflection::BindingFlags::InvokeMethod, 
        Type::DefaultBinder, obj, gcnew array<Object^> { "Hello" });

    ITest^ it = (ITest^) obj;
    it->Test("Hi");

    MarshalableExample^ ex = (MarshalableExample^) obj;
    ex->Test("Goodbye");
}

/* This example produces the following output:

Hello from 'MyDomain'!
Hi from 'MyDomain'!
Goodbye from 'MyDomain'!
 */

using System;

public interface ITest
{
    void Test(string greeting);
}

public class MarshalableExample : MarshalByRefObject, ITest
{
    static void Main()
    {
        // Construct a path to the current assembly.
        string assemblyPath = Environment.CurrentDirectory + "\\" +
            typeof(MarshalableExample).Assembly.GetName().Name + ".exe";

        AppDomain ad = AppDomain.CreateDomain("MyDomain");

        System.Runtime.Remoting.ObjectHandle oh =
            ad.CreateInstanceFrom(assemblyPath, "MarshalableExample");

        object obj = oh.Unwrap();

        // Three ways to use the newly created object, depending on how
        // much is known about the type: Late bound, early bound through
        // a mutually known interface, or early binding of a known type.
        //
        obj.GetType().InvokeMember("Test",
            System.Reflection.BindingFlags.InvokeMethod,
            Type.DefaultBinder, obj, new object[] { "Hello" });

        ITest it = (ITest) obj;
        it.Test("Hi");

        MarshalableExample ex = (MarshalableExample) obj;
        ex.Test("Goodbye");
    }

    public void Test(string greeting)
    {
        Console.WriteLine("{0} from '{1}'!", greeting,
            AppDomain.CurrentDomain.FriendlyName);
    }
}

/* This example produces the following output:

Hello from 'MyDomain'!
Hi from 'MyDomain'!
Goodbye from 'MyDomain'!
 */

open System

type ITest =
    abstract Test: string -> unit

type MarshalableExample() =
    inherit MarshalByRefObject()
    
    member _.Test greeting =
        printfn $"{greeting} from '{AppDomain.CurrentDomain.FriendlyName}'!"

    interface ITest with
        member this.Test message = this.Test message 

// Construct a path to the current assembly.
let assemblyPath = 
    Environment.CurrentDirectory + "\\" + typeof<MarshalableExample>.Assembly.GetName().Name + ".exe"

let ad = AppDomain.CreateDomain "MyDomain"

let oh =
    ad.CreateInstanceFrom(assemblyPath, "MarshalableExample")

let obj = oh.Unwrap()

// Three ways to use the newly created object, depending on how
// much is known about the type: Late bound, early bound through
// a mutually known interface, or early binding of a known type.
//
obj.GetType().InvokeMember("Test",
    System.Reflection.BindingFlags.InvokeMethod,
    Type.DefaultBinder, obj, [| box "Hello" |])
|> ignore

let it = obj :?> ITest
it.Test "Hi"

let ex = obj :?> MarshalableExample
ex.Test("Goodbye")

(* This example produces the following output:

Hello from 'MyDomain'!
Hi from 'MyDomain'!
Goodbye from 'MyDomain'!
 *)

Public Interface ITest

    Sub Test(ByVal greeting As String)
End Interface

Public Class MarshalableExample 
    Inherits MarshalByRefObject
    Implements ITest

    Shared Sub Main()
    
        ' Construct a path to the current assembly.
        Dim assemblyPath As String = Environment.CurrentDirectory & "\" &
            GetType(MarshalableExample).Assembly.GetName().Name & ".exe"

        Dim ad As AppDomain = AppDomain.CreateDomain("MyDomain")
 
        Dim oh As System.Runtime.Remoting.ObjectHandle = 
            ad.CreateInstanceFrom(assemblyPath, "MarshalableExample")

        Dim obj As Object = oh.Unwrap()


        ' Three ways to use the newly created object, depending on how
        ' much is known about the type: Late bound, early bound through 
        ' a mutually known interface, or early binding of a known type.
        '
        obj.GetType().InvokeMember("Test", 
            System.Reflection.BindingFlags.InvokeMethod, 
            Type.DefaultBinder, obj, New Object() { "Hello" })

        Dim it As ITest = CType(obj, ITest) 
        it.Test("Hi")

        Dim ex As MarshalableExample = CType(obj, MarshalableExample) 
        ex.Test("Goodbye")
    End Sub

    Public Sub Test(ByVal greeting As String) Implements ITest.Test
    
        Console.WriteLine("{0} from '{1}'!", greeting,
            AppDomain.CurrentDomain.FriendlyName)
    End Sub
End Class

' This example produces the following output:
'
'Hello from 'MyDomain'!
'Hi from 'MyDomain'!
'Goodbye from 'MyDomain'!

Poznámky

Vyvolá se konstruktor bez parametrů pro typeName .

Další informace najdete v Activator.CreateInstanceFrom metodě.

Pokud se CreateInstanceFrom metoda použije k vytvoření instance v cílové doméně aplikace, kromě domény aplikace, ze které je volání provedeno, sestavení se načte v cílové doméně aplikace. Pokud je však v doméně aplikace instance nezabalená, použití nezabalené instance může v určitých případech způsobit zavedení sestavení do domény volající aplikace. Například po rozbalení instance mohou být vyžadovány její informace o typech, které jsou nutné pro volání obsažených metod pozdní vazbou. Po zavedení sestavení do domény volající aplikace může dojít k výjimkám.

• Pokud byla do domény volající aplikace dříve načtena jiná verze stejného sestavení nebo pokud se cesta načítání volající domény aplikace liší od cílové domény aplikace, může dojít k výjimkám, jako MissingMethodException je například.

• Pokud doména volající aplikace provádí dřívější volání typu instance, InvalidCastException může být vyvolán při pokusu o přetypování instance.

Viz také

• CreateInstanceFrom(String, String)