AppDomain.CreateInstanceFrom Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.

Túlterhelések

Name	Description
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.
CreateInstanceFrom(String, String, Object[])	Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.
CreateInstanceFrom(String, String)	Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.

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

Forrás:

AppDomain.cs

Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.

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

Paraméterek

assemblyFile

String

A kért típust meghatározó szerelvényt tartalmazó fájl neve, beleértve az elérési utat is. A rendszer betölti a szerelvényt a LoadFrom(String) módszerrel.

typeName

String

A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.

ignoreCase

Boolean

Logikai érték, amely meghatározza, hogy kis- és nagybetűkre érzékeny keresést hajt-e végre.

bindingAttr

BindingFlags

Nulla vagy több bitjelző kombinációja, amelyek befolyásolják a konstruktor keresését typeName . Ha bindingAttr nulla, akkor a rendszer megkülönbözteti a nyilvános konstruktorok kis- és nagybetűket.

binder

Binder

Olyan objektum, amely lehetővé teszi az argumentumtípusok kötését, kényszerítését, a tagok meghívását és az objektumok visszaverésen keresztüli lekérését MemberInfo . Null érték esetén binder a rendszer az alapértelmezett kötőanyagot használja.

args

Object[]

A konstruktornak átadni kívánt argumentumok. Ennek az argumentumtömbnek számban, sorrendben kell egyeznie, és be kell gépelnie a meghívandó konstruktor paramétereit. Ha előnyben részesíti a paraméter nélküli konstruktort, args üres tömbnek vagy nullnak kell lennie.

culture

CultureInfo

Kultúraspecifikus információk, amelyek a konstruktor számára args deklarált formális típusok kényszerítésére typeName vonatkoznak. Ha culture igen null, akkor a rendszer az CultureInfo aktuális szálat használja.

activationAttributes

Object[]

Egy vagy több attribútum tömbje, amely részt vehet az aktiválásban. Általában egy olyan tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektum aktiválásához szükséges URL-címet.

Ez a paraméter ügyfél által aktivált objektumokhoz kapcsolódik. Az ügyfélaktiválás egy régi technológia, amely megmarad a visszamenőleges kompatibilitás érdekében, de nem ajánlott az új fejlesztéshez. Az elosztott alkalmazásoknak ehelyett Windows kommunikációs alaprendszer kell használniuk.

Válaszok

ObjectHandle

Olyan objektum, amely az új példány burkolója, vagy null ha typeName nem található. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.

Attribútumok

RequiresUnreferencedCodeAttribute

Kivételek

ArgumentNullException

assemblyFile az null.

-vagy-

typeName az null.

NotSupportedException

A hívó nem tud aktiválási attribútumokat megadni egy olyan objektumhoz, amely nem öröklődik.MarshalByRefObject

AppDomainUnloadedException

A művelet egy kiürített alkalmazástartományon van megkísérlve.

FileNotFoundException

assemblyFile nem található.

TypeLoadException

typeName nem található a következőben assemblyFile: .

MissingMethodException

Nem található egyező nyilvános konstruktor.

MethodAccessException

A hívó nem rendelkezik megfelelő engedéllyel a konstruktor meghívásához.

BadImageFormatException

assemblyFile nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.

FileLoadException

Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.

NullReferenceException

Ez a példány .null

Megjegyzések

További információkért tekintse meg a metódust Activator.CreateInstanceFrom .

Ha a CreateInstanceFrom metódussal egy példányt hoz létre egy célalkalmazás-tartományban, a hívás alapjául szolgáló alkalmazástartománytól eltérő alkalmazástartományban, a rendszer betölti a szerelvényt a célalkalmazás tartományba. Ha azonban a példány le van bontva a hívó alkalmazás tartományában, a le nem írt példány bizonyos módokon történő használata a szerelvényt betöltheti a hívó alkalmazás tartományába. Ha például a példány le van bontva, előfordulhat, hogy a típusadatok lekérése szükséges, hogy a metódusok késve legyenek megkötve. Amikor a szerelvény be van töltve a hívó alkalmazás tartományába, kivételek léphetnek fel.

• Ha ugyanannak a szerelvénynek egy másik verzióját korábban betöltötték a hívó alkalmazás tartományába, vagy ha a hívó alkalmazás tartományának betöltési útvonala eltér a célalkalmazás tartományától, akkor előfordulhatnak MissingMethodException például kivételek.

• Ha a hívó alkalmazás tartománya korai kötésű hívásokat indít a példány típusára, InvalidCastException akkor a példány leadására tett kísérlet esetén is kezdeményezhető.

Lásd még

• CreateInstanceFrom(String, String)

CreateInstanceFrom(String, String, Object[])

Forrás:

AppDomain.cs

Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.

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

Paraméterek

assemblyFile

String

A kért típust meghatározó szerelvényt tartalmazó fájl neve, beleértve az elérési utat is. A rendszer betölti a szerelvényt a LoadFrom(String) módszerrel.

typeName

String

A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.

activationAttributes

Object[]

Egy vagy több attribútum tömbje, amely részt vehet az aktiválásban. Általában egy olyan tömb, amely egyetlen UrlAttribute objektumot tartalmaz, amely megadja a távoli objektum aktiválásához szükséges URL-címet.

Ez a paraméter ügyfél által aktivált objektumokhoz kapcsolódik. Az ügyfélaktiválás egy régi technológia, amely megmarad a visszamenőleges kompatibilitás érdekében, de nem ajánlott az új fejlesztéshez. Az elosztott alkalmazásoknak ehelyett Windows kommunikációs alaprendszer kell használniuk.

Válaszok

ObjectHandle

Olyan objektum, amely az új példány burkolója, vagy null ha typeName nem található. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.

Attribútumok

RequiresUnreferencedCodeAttribute

Kivételek

ArgumentNullException

assemblyFile az null.

FileNotFoundException

assemblyFile nem található.

TypeLoadException

typeName nem található a következőben assemblyFile: .

MethodAccessException

A hívó nem rendelkezik megfelelő engedéllyel a konstruktor meghívásához.

MissingMethodException

Nem található egyező nyilvános konstruktor.

NotSupportedException

A hívó nem tud aktiválási attribútumokat megadni egy olyan objektumhoz, amely nem öröklődik.MarshalByRefObject

AppDomainUnloadedException

A művelet egy kiürített alkalmazástartományon van megkísérlve.

BadImageFormatException

assemblyFile nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.

FileLoadException

Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.

NullReferenceException

Ez a példány .null

Megjegyzések

A paraméter nélküli konstruktor meghívása typeName történik.

A metódussal kapcsolatos további információkért tekintse meg a metódust Activator.CreateInstanceFrom .

Ha a CreateInstanceFrom metódussal egy példányt hoz létre egy célalkalmazás-tartományban, a hívás alapjául szolgáló alkalmazástartománytól eltérő alkalmazástartományban, a rendszer betölti a szerelvényt a célalkalmazás tartományba. Ha azonban a példány le van bontva a hívó alkalmazás tartományában, a le nem írt példány bizonyos módokon történő használata a szerelvényt betöltheti a hívó alkalmazás tartományába. Ha például a példány le van bontva, előfordulhat, hogy a típusadatok lekérése szükséges, hogy a metódusok késve legyenek megkötve. Amikor a szerelvény be van töltve a hívó alkalmazás tartományába, kivételek léphetnek fel.

• Ha ugyanannak a szerelvénynek egy másik verzióját korábban betöltötték a hívó alkalmazás tartományába, vagy ha a hívó alkalmazás tartományának betöltési útvonala eltér a célalkalmazás tartományától, akkor előfordulhatnak MissingMethodException például kivételek.

• Ha a hívó alkalmazás tartománya korai kötésű hívásokat indít a példány típusára, InvalidCastException akkor a példány leadására tett kísérlet esetén is kezdeményezhető.

Lásd még

• CreateInstanceFrom(String, String)

CreateInstanceFrom(String, String)

Forrás:

AppDomain.cs

Létrehoz egy új példányt a megadott szerelvényfájlban definiált megadott típusból.

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

Paraméterek

assemblyFile

String

A kért típust meghatározó szerelvényt tartalmazó fájl neve, beleértve az elérési utat is. A rendszer betölti a szerelvényt a LoadFrom(String) módszerrel.

typeName

String

A kért típus teljes neve, beleértve a névteret, de a szerelvényt nem, a FullName tulajdonság által visszaadott módon.

Válaszok

ObjectHandle

Olyan objektum, amely az új példány burkolója, vagy null ha typeName nem található. A visszatérési értéket le kell bontani a valódi objektum eléréséhez.

Attribútumok

RequiresUnreferencedCodeAttribute

Kivételek

ArgumentNullException

assemblyFile az null.

-vagy-

typeName az null.

FileNotFoundException

assemblyFile nem található.

TypeLoadException

typeName nem található a következőben assemblyFile: .

AppDomainUnloadedException

A művelet egy kiürített alkalmazástartományon van megkísérlve.

MissingMethodException

Nem található paraméter nélküli nyilvános konstruktor.

MethodAccessException

A hívó nem rendelkezik megfelelő engedéllyel a konstruktor meghívásához.

BadImageFormatException

assemblyFile nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.

FileLoadException

Egy szerelvényt vagy modult kétszer töltöttek be két különböző bizonyítékkal.

NullReferenceException

Ez a példány .null

Példák

Az alábbi példa bemutatja, hogyan lehet a CreateInstanceFrom(String, String) metódust túlterheléssel létrehozni egy objektumpéldányt egy célalkalmazás-tartományban, és meghívni annak metódusait.

A példa meghatározza azt az MarshalableExample osztályt, amely az alkalmazástartományok határain keresztül is telepíthető. A példa létrehozza a jelenleg futó szerelvény elérési útját, létrehoz egy célalkalmazás-tartományt, és a CreateInstanceFrom(String, String) metódus túlterhelésével betölti a példaszerelvényt a célalkalmazás tartományába, és létrehoz egy példányt MarshalableExample.

Note

Az elérési út ebben a példában abszolút, de egy relatív elérési út is működni fog, mert a metódus a Assembly.LoadFrom szerelvény betöltésére szolgál.

Az objektumfogópont leválasztása után a példa három módszert mutat be egy objektum célalkalmazás-tartományban való használatára:

• Metódus meghívása késői kötéssel, tükröződés használatával. Ehhez típusadatokra van szükség, ami miatt a szerelvény betöltődik a hívó alkalmazástartományába. (Ebben a példában már be van töltve.)

• Az objektumot a hívó és a hívó számára is ismert felületre öntötte. Ha az interfész a hívó szerelvényben vagy a hívó és a hívó által hivatkozott harmadik szerelvényben van definiálva, a rendszer nem tölti be a hívott szerelvényt a hívó alkalmazástartományába.

• Az objektum közvetlen használata, ha annak típusa ismert a hívó számára. A szerelvényt be kell tölteni a hívó alkalmazástartományába.

A hívott szerelvénynek a hívó alkalmazástartományába való betöltésének egy másik módja, ha a hívó az MarshalByRefObject osztályból származik, és meghatároz egy metódust, amely futtatható a célalkalmazás-tartományban. Ez a metódus tükrözés használatával vizsgálhat meg egy célszerelvényt, mivel a célszerelvény már be van töltve a célalkalmazás tartományába. Lásd a tulajdonság példáját 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'!

Megjegyzések

A paraméter nélküli konstruktor meghívása typeName történik.

További információkért tekintse meg a metódust Activator.CreateInstanceFrom .

Ha a CreateInstanceFrom metódussal egy példányt hoz létre egy célalkalmazás-tartományban, a hívás alapjául szolgáló alkalmazástartománytól eltérő alkalmazástartományban, a rendszer betölti a szerelvényt a célalkalmazás tartományba. Ha azonban a példány le van bontva a hívó alkalmazás tartományában, a le nem írt példány bizonyos módokon történő használata a szerelvényt betöltheti a hívó alkalmazás tartományába. Ha például a példány le van bontva, előfordulhat, hogy a típusadatok lekérése szükséges, hogy a metódusok késve legyenek megkötve. Amikor a szerelvény be van töltve a hívó alkalmazás tartományába, kivételek léphetnek fel.

• Ha ugyanannak a szerelvénynek egy másik verzióját korábban betöltötték a hívó alkalmazás tartományába, vagy ha a hívó alkalmazás tartományának betöltési útvonala eltér a célalkalmazás tartományától, akkor előfordulhatnak MissingMethodException például kivételek.

• Ha a hívó alkalmazás tartománya korai kötésű hívásokat indít a példány típusára, InvalidCastException akkor a példány leadására tett kísérlet esetén is kezdeményezhető.

Lásd még

• CreateInstanceFrom(String, String)