Activator Klasa

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

Activator.cs

Zawiera metody tworzenia typów obiektów lokalnie lub zdalnie lub uzyskiwania odwołań do istniejących obiektów zdalnych. Klasa ta nie może być dziedziczona.

public ref class Activator abstract sealed

public static class Activator

type Activator = class

Public Class Activator

Dziedziczenie

Object

Activator

Przykłady

W poniższym przykładzie pokazano, jak używać Activator klasy do dynamicznego konstruowania obiektów w czasie wykonywania.

using namespace System;
using namespace System::Reflection;
using namespace System::Text;

public ref class SomeType
{
public:
    void DoSomething(int x)
    {
        Console::WriteLine("100 / {0} = {1}", x, 100 / x);
    }
};

void main()
{
    // Create an instance of the StringBuilder type using 
    // Activator.CreateInstance.
    Object^ o = Activator::CreateInstance(StringBuilder::typeid);

    // Append a string into the StringBuilder object and display the 
    // StringBuilder.
    StringBuilder^ sb = (StringBuilder^) o;
    sb->Append("Hello, there.");
    Console::WriteLine(sb);

    // Create an instance of the SomeType class that is defined in this 
    // assembly.
    System::Runtime::Remoting::ObjectHandle^ oh = 
        Activator::CreateInstanceFrom(Assembly::GetEntryAssembly()->CodeBase, 
                                      SomeType::typeid->FullName);

    // Call an instance method defined by the SomeType type using this object.
    SomeType^ st = (SomeType^) oh->Unwrap();

    st->DoSomething(5);
};

/* This code produces the following output:
 
Hello, there.
100 / 5 = 20
 */

using System;
using System.Reflection;
using System.Text;

public class SomeType
{
    public void DoSomething(int x)
    {
        Console.WriteLine("100 / {0} = {1}", x, 100 / x);
    }
}

public class Example
{
    static void Main()
    {
        // Create an instance of the StringBuilder type using
        // Activator.CreateInstance.
        Object o = Activator.CreateInstance(typeof(StringBuilder));

        // Append a string into the StringBuilder object and display the
        // StringBuilder.
        StringBuilder sb = (StringBuilder) o;
        sb.Append("Hello, there.");
        Console.WriteLine(sb);

        // Create an instance of the SomeType class that is defined in this
        // assembly.
        System.Runtime.Remoting.ObjectHandle oh =
            Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase,
                                         typeof(SomeType).FullName);

        // Call an instance method defined by the SomeType type using this object.
        SomeType st = (SomeType) oh.Unwrap();

        st.DoSomething(5);
    }
}

/* This code produces the following output:

Hello, there.
100 / 5 = 20
 */

open System
open System.Reflection
open System.Text

type SomeType() =
    member _.DoSomething(x) = printfn $"100 / {x} = {100 / x}"

// Create an instance of the StringBuilder type using Activator.CreateInstance.
let o = Activator.CreateInstance typeof<StringBuilder>

// Append a string into the StringBuilder object and display the StringBuilder.
let sb = o :?> StringBuilder
sb.Append "Hello, there." |> ignore
printfn $"{sb}"

// Create an instance of the SomeType class that is defined in this assembly.
let oh = 
    Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().Location, typeof<SomeType>.FullName)

// Call an instance method defined by the SomeType type using this object.
let st = oh.Unwrap() :?> SomeType

st.DoSomething 5

(* This code produces the following output:

Hello, there.
100 / 5 = 20
 *)

Imports System.Reflection
Imports System.Text

Module Module1
    Sub Main()
        ' Create an instance of the StringBuilder type using 
        ' Activator.CreateInstance.
        Dim o As Object = Activator.CreateInstance(GetType(StringBuilder))

        ' Append a string into the StringBuilder object and display the 
        ' StringBuilder.
        Dim sb As StringBuilder = CType(o, StringBuilder)
        sb.Append("Hello, there.")
        Console.WriteLine(sb)

        ' Create an instance of the SomeType class that is defined in this assembly.
        Dim oh As System.Runtime.Remoting.ObjectHandle = _
            Activator.CreateInstanceFrom(Assembly.GetEntryAssembly().CodeBase, _
                                         GetType(SomeType).FullName)

        ' Call an instance method defined by the SomeType type using this object.
        Dim st As SomeType = CType(oh.Unwrap(), SomeType)

        st.DoSomething(5)
    End Sub

    Class SomeType
        Public Sub DoSomething(ByVal x As Int32)
            Console.WriteLine("100 / {0} = {1}", x, 100 \ x)
        End Sub
    End Class
End Module

' This code produces the following output:
' 
' Hello, there.
' 100 / 5 = 20

Uwagi

Metoda CreateInstance tworzy wystąpienie typu zdefiniowanego w zestawie przez wywołanie konstruktora, który najlepiej pasuje do określonych argumentów. Jeśli nie określono żadnych argumentów, konstruktor, który nie przyjmuje żadnych parametrów, czyli konstruktor bez parametrów, jest wywoływany.

Musisz mieć wystarczające uprawnienia do wyszukiwania i wywoływania konstruktora; w przeciwnym razie zgłaszany jest wyjątek. Domyślnie podczas wyszukiwania konstruktora są brane pod uwagę tylko publiczne konstruktory. Jeśli nie można odnaleźć konstruktora ani konstruktora bez parametrów, zgłaszany jest wyjątek.

Parametr binder określa obiekt, który wyszukuje zestaw dla odpowiedniego konstruktora. Możesz określić własne kryteria powiązania i wyszukiwania. Jeśli nie określono żadnego powiązania, zostanie użyty domyślny binder. Aby uzyskać więcej informacji, zobacz System.Reflection.Binder klasy i System.Reflection.BindingFlags .

Parametr dowodu wpływa na zasady zabezpieczeń i uprawnienia konstruktora. Aby uzyskać więcej informacji, zobacz klasę System.Security.Policy.Evidence .

Wystąpienie typu można utworzyć w lokacji lokalnej lub zdalnej. Jeśli typ jest tworzony zdalnie, parametr atrybutu aktywacji określa identyfikator URI lokacji zdalnej. Wywołanie w celu utworzenia wystąpienia może przechodzić przez lokacje pośredniczące przed dotarciem do lokacji zdalnej. Inne atrybuty aktywacji mogą modyfikować środowisko lub kontekst, w którym wywołanie działa w lokacjach zdalnych i pośrednich.

Jeśli wystąpienie jest tworzone lokalnie, zwracane jest odwołanie do tego obiektu. Jeśli wystąpienie jest tworzone zdalnie, zwracane jest odwołanie do serwera proxy. Obiekt zdalny jest manipulowany za pośrednictwem serwera proxy tak, jakby był to obiekt lokalny.

Metoda GetObject tworzy serwer proxy do aktualnie uruchomionego obiektu zdalnego, dobrze aktywowanego obiektu serwera lub usługi sieci Web XML. Możesz określić nośnik połączenia, czyli kanał. Aby uzyskać więcej informacji, zobacz klasę System.Runtime.Remoting.Channels.ChannelServices .

Zestawy zawierają definicje typów. Metoda CreateInstance tworzy wystąpienie typu na podstawie aktualnie uruchomionego zestawu. Metoda CreateInstanceFrom tworzy wystąpienie na podstawie pliku zawierającego zestaw. Metoda CreateComInstanceFrom tworzy wystąpienie obiektu COM z pliku zawierającego zestaw.

Metody

CreateInstance(String, String)	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego zestawu i konstruktora bez parametrów.
CreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego zestawu i konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(String, String, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego zestawu i konstruktora bez parametrów.
CreateInstance(Type)	Tworzy wystąpienie określonego typu przy użyciu konstruktora bez parametrów tego typu.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, Boolean)	Tworzy wystąpienie określonego typu przy użyciu konstruktora bez parametrów tego typu.
CreateInstance(Type, Object[])	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance(Type, Object[], Object[])	Tworzy wystąpienie określonego typu przy użyciu konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstance<T>()	Tworzy wystąpienie typu wyznaczonego przez określony parametr typu ogólnego przy użyciu konstruktora bez parametrów.
CreateInstanceFrom(String, String)	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora bez parametrów.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora, który najlepiej pasuje do określonych parametrów.
CreateInstanceFrom(String, String, Object[])	Tworzy wystąpienie typu, którego nazwa jest określona, przy użyciu nazwanego pliku zestawu i konstruktora bez parametrów.