AppDomain.CreateInstanceFrom Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Vytvoří novou instanci zadaného typu definovaného v zadaném souboru sestavení.

Přetížení

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

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

Zdroj:

AppDomain.cs

Vytvoří novou instanci zadaného typu definovaného v zadané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);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
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);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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, který obsahuje sestavení definující požadovaný typ, včetně cesty. Sestavení se načte pomocí LoadFrom(String) metody.

typeName

String

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

ignoreCase

Boolean

Logická hodnota určující, jestli se má hledat s rozlišováním velkých a malých písmen, nebo ne.

bindingAttr

BindingFlags

Kombinace nulových nebo více bitových příznaků, které ovlivňují hledání konstruktoru typeName . Pokud bindingAttr je 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, převod typů argumentů, vyvolání členů a načtení MemberInfo objektů prostřednictvím reflexe. Pokud binder je null, použije se výchozí pořadač.

args

Object[]

Argumenty, které se mají předat konstruktoru. Toto pole argumentů se musí shodovat s číslem, pořadím a zadáním parametrů konstruktoru, které se mají vyvolat. Pokud je upřednostňovaný konstruktor bez parametrů, args musí být prázdné pole nebo hodnota null.

culture

CultureInfo

Informace specifické pro jazykovou verzi, které řídí převod na args formální typy deklarované pro typeName konstruktor. Pokud culture je null, použije se CultureInfo pro aktuální vlákno.

activationAttributes

Object[]

Pole jednoho nebo více atributů, které se mohou účastnit aktivace. Obvykle 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. Aby bylo možné získat přístup k skutečnému objektu, musí být vrácená hodnota bez přepsání.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

assemblyFile je null.

nebo

typeName je null.

NotSupportedException

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

AppDomainUnloadedException

Operace se pokusí o uvolněnou doménu 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í k volání tohoto konstruktoru.

BadImageFormatException

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

FileLoadException

Sestavení nebo modul byl načten dvakrát se dvěma různými důkazy.

NullReferenceException

Tato instance je null.

Poznámky

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

CreateInstanceFrom Pokud se metoda používá k vytvoření instance v cílové doméně aplikace, kromě domény aplikace, ze které je volání provedeno, sestavení se načte do domény cílové aplikace. Pokud je však instance rozbalená v doméně volající aplikace, může použití nezabalené instance určitým způsobem způsobit načtení sestavení do volající domény aplikace. Například po zrušení přepsání instance může být požadována informace o typu, aby bylo možné volat metody opožděné vazby. Při načtení sestavení do volající domény aplikace může dojít k výjimkám.

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

• Pokud volající doména aplikace provádí volání typu instance v rané fázi, 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 zadaného typu definovaného v zadaném souboru sestavení.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName, object?[]? activationAttributes);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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, který obsahuje sestavení definující požadovaný typ, včetně cesty. Sestavení se načte pomocí LoadFrom(String) metody.

typeName

String

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

activationAttributes

Object[]

Pole jednoho nebo více atributů, které se mohou účastnit aktivace. Obvykle 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. Aby bylo možné získat přístup k skutečnému objektu, musí být vrácená hodnota bez přepsání.

Atributy

RequiresUnreferencedCodeAttribute

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í k volání tohoto konstruktoru.

MissingMethodException

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

NotSupportedException

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

AppDomainUnloadedException

Operace se pokusí o uvolněnou doménu aplikace.

BadImageFormatException

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

FileLoadException

Sestavení nebo modul byl načten dvakrát se dvěma různými důkazy.

NullReferenceException

Tato instance je null.

Poznámky

Vyvolá se konstruktor bez parametrů pro typeName .

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

CreateInstanceFrom Pokud se metoda používá k vytvoření instance v cílové doméně aplikace, kromě domény aplikace, ze které je volání provedeno, sestavení se načte do domény cílové aplikace. Pokud je však instance rozbalená v doméně volající aplikace, může použití nezabalené instance určitým způsobem způsobit načtení sestavení do volající domény aplikace. Například po zrušení přepsání instance může být požadována informace o typu, aby bylo možné volat metody opožděné vazby. Při načtení sestavení do volající domény aplikace může dojít k výjimkám.

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

• Pokud volající doména aplikace provádí volání typu instance v rané fázi, 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 zadaného typu definovaného v zadaném souboru sestavení.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")]
public System.Runtime.Remoting.ObjectHandle? CreateInstanceFrom(string assemblyFile, string typeName);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Type and its constructor could be removed")>]
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, který obsahuje sestavení definující požadovaný typ, včetně cesty. Sestavení se načte pomocí LoadFrom(String) metody.

typeName

String

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

Návraty

ObjectHandle

Objekt, který je obálkou pro novou instanci nebo null pokud typeName nebyl nalezen. Aby bylo možné získat přístup k skutečnému objektu, musí být vrácená hodnota bez přepsání.

Atributy

RequiresUnreferencedCodeAttribute

Výjimky

ArgumentNullException

assemblyFile je null.

nebo

typeName je null.

FileNotFoundException

assemblyFile nebyl nalezen.

TypeLoadException

typeName nebyl nalezen v assemblyFilesouboru .

AppDomainUnloadedException

Operace se pokusí o uvolněnou doménu aplikace.

MissingMethodException

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

MethodAccessException

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

BadImageFormatException

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

FileLoadException

Sestavení nebo modul byl načten dvakrát se dvěma různými důkazy.

NullReferenceException

Tato instance je null.

Příklady

Následující příklad ukazuje, jak pomocí CreateInstanceFrom(String, String) přetížení metody vytvořit instanci objektu v cílové doméně aplikace a volat její metody.

Příklad definuje MarshalableExample třídu, která může být zařazována přes hranice 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, které způsobí načtení sestavení 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ý, volána sestavení se nenačte do domény aplikace volajícího.

• Použití objektu přímo, když 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, aby volající odvozen od MarshalByRefObject třídy a definoval metodu, která se dá spustit v cílové doméně aplikace. Tato metoda může použít reflexi k prozkoumá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 vlastnosti DynamicDirectory .

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 metodě Activator.CreateInstanceFrom.

CreateInstanceFrom Pokud se metoda používá k vytvoření instance v cílové doméně aplikace, kromě domény aplikace, ze které je volání provedeno, sestavení se načte do domény cílové aplikace. Pokud je však instance rozbalená v doméně volající aplikace, může použití nezabalené instance určitým způsobem způsobit načtení sestavení do volající domény aplikace. Například po zrušení přepsání instance může být požadována informace o typu, aby bylo možné volat metody opožděné vazby. Při načtení sestavení do volající domény aplikace může dojít k výjimkám.

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

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

Viz také

• CreateInstanceFrom(String, String)