Activator.CreateInstanceFrom Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Adlandırılmış derleme dosyasını ve belirtilen parametrelerle en iyi eşleşen oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.

Aşırı Yüklemeler

CreateInstanceFrom(String, String, Object[])	Adlandırılmış derleme dosyasını ve parametresiz oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.
CreateInstanceFrom(String, String)	Adlandırılmış derleme dosyasını ve parametresiz oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Adlandırılmış derleme dosyasını ve belirtilen parametrelerle en iyi eşleşen oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.

CreateInstanceFrom(String, String, Object[])

Kaynak:

Activator.cs

Adlandırılmış derleme dosyasını ve parametresiz oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.

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

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

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

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

Parametreler

assemblyFile

String

typeName adlı türün arandığı bir derleme içeren dosyanın adı.

typeName

String

Örneği oluşturulacak türün adı.

activationAttributes

Object[]

Etkinleştirmeye katılabilen bir veya daha fazla öznitelik dizisi. Bu genellikle uzak bir nesneyi etkinleştirmek için gereken URL'yi belirten tek bir UrlAttribute nesnesi içeren bir dizidir.

Bu parametre istemci tarafından etkinleştirilen nesnelerle ilgilidir. İstemci etkinleştirmesi, geriye dönük uyumluluk için korunan ancak yeni geliştirme için önerilmez eski bir teknolojidir. Dağıtılmış uygulamalar bunun yerine Windows Communication Foundation kullanmalıdır.

Döndürülenler

ObjectHandle

Yeni oluşturulan nesneye erişmek için sarmalanmamış olması gereken bir tanıtıcı veya Nullable<T> örnekleri için null.

Özel durumlar

ArgumentNullException

typeName null.

MissingMethodException

Eşleşen ortak oluşturucu bulunamadı.

TypeLoadException

typeName assemblyFilebulunamadı.

FileNotFoundException

assemblyFile bulunamadı.

MethodAccessException

Çağıranın bu oluşturucuyu çağırma izni yok.

MemberAccessException

Soyut bir sınıfın örneği oluşturulamıyor veya bu üye geç bağlama mekanizmasıyla çağrıldı.

TargetInvocationException

Yansıma aracılığıyla çağrılan oluşturucu bir özel durum oluşturdu.

NotSupportedException

activationAttributes boş bir dizi değildir ve oluşturulan tür MarshalByRefObjecttüretilmez.

SecurityException

Çağıranın gerekli FileIOPermissionvar.

BadImageFormatException

assemblyFile geçerli bir derleme değil.

-veya-

Ortak dil çalışma zamanı (CLR) sürüm 2.0 veya üzeri şu anda yüklüdür ve assemblyFile şu anda yüklü olan sürümden sonraki bir CLR sürümü için derlendi. .NET Framework'ün 2.0, 3.0 ve 3.5 sürümlerinin tümünün CLR sürüm 2.0'ı kullandığını unutmayın.

Açıklamalar

dönüş değerini açmak için ObjectHandle.Unwrap yöntemini kullanın.

Çağrılan yöntemler tarafından oluşturulabilecek diğer özel durumlar hakkında bilgi için Assembly.LoadFrom ve CreateInstance yöntemlerinin Özel Durumlar bölümüne bakın.

CreateInstanceFrom(String, String)

Kaynak:

Activator.cs

Adlandırılmış derleme dosyasını ve parametresiz oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.

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

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

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

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

Parametreler

assemblyFile

String

typeName adlı türün arandığı bir derleme içeren dosyanın adı.

typeName

String

Örneği oluşturulacak türün adı.

Döndürülenler

ObjectHandle

Yeni oluşturulan nesneye erişmek için sarmalanmamış olması gereken bir tanıtıcı veya Nullable<T> örnekleri için null.

Özel durumlar

ArgumentNullException

typeName null.

MissingMethodException

Eşleşen ortak oluşturucu bulunamadı.

TypeLoadException

typeName assemblyFilebulunamadı.

FileNotFoundException

assemblyFile bulunamadı.

MethodAccessException

Çağıranın bu oluşturucuyu çağırma izni yok.

MemberAccessException

Soyut bir sınıfın örneği oluşturulamıyor veya bu üye geç bağlama mekanizmasıyla çağrıldı.

TargetInvocationException

Yansıma aracılığıyla çağrılan oluşturucu bir özel durum oluşturdu.

SecurityException

Çağıranın gerekli FileIOPermissionvar.

BadImageFormatException

assemblyFile geçerli bir derleme değil.

-veya-

Ortak dil çalışma zamanı (CLR) sürüm 2.0 veya üzeri şu anda yüklüdür ve assemblyFile şu anda yüklü olan sürümden sonraki bir CLR sürümü için derlendi. .NET Framework'ün 2.0, 3.0 ve 3.5 sürümlerinin tümünün CLR sürüm 2.0'ı kullandığını unutmayın.

Örnekler

Aşağıdaki kod örneği, CreateInstanceFrom yönteminin nasıl çağrılduğunu gösterir. Bu kod örneği, Activator sınıfı için sağlanan daha büyük bir örneğin parçasıdır.

// 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);

// 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);

// 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

' 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)

Açıklamalar

dönüş değerini açmak için ObjectHandle.Unwrap yöntemini kullanın.

Çağrılan yöntemler tarafından oluşturulabilecek diğer özel durumlar hakkında bilgi için Assembly.LoadFrom ve CreateInstance yöntemlerinin Özel Durumlar bölümüne bakın.

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

Kaynak:

Activator.cs

Adlandırılmış derleme dosyasını ve belirtilen parametrelerle en iyi eşleşen oluşturucuyu kullanarak adı belirtilen türün bir örneğini oluşturur.

public:
 static 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 static 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);

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

Public Shared 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

Parametreler

assemblyFile

String

typeName adlı türün arandığı bir derleme içeren dosyanın adı.

typeName

String

Örneği oluşturulacak türün adı.

ignoreCase

Boolean

typeName aramasının büyük/küçük harfe duyarlı olmadığını belirtmek true; Aramanın büyük/küçük harfe duyarlı olduğunu belirtmek için false.

bindingAttr

BindingFlags

typeName oluşturucu aramasını etkileyen sıfır veya daha fazla bit bayrağının birleşimi. bindingAttr sıfırsa, ortak oluşturucular için büyük/küçük harfe duyarlı bir arama yapılır.

binder

Binder

typeName oluşturucuyu aramak ve tanımlamak için bindingAttr ve args kullanan bir nesne. binder nullise, varsayılan bağlayıcı kullanılır.

args

Object[]

Çağrılacak oluşturucunun parametrelerini sayı, sıra ve tür olarak eşleşen bir bağımsız değişken dizisi. args boş bir dizi veya nullise, parametre içermeyen oluşturucu (parametresiz oluşturucu) çağrılır.

culture

CultureInfo

args zorlamasını typeName oluşturucu için bildirilen resmi türlerle yöneten kültüre özgü bilgiler. culture nullise, geçerli iş parçacığının CultureInfo kullanılır.

activationAttributes

Object[]

Etkinleştirmeye katılabilen bir veya daha fazla öznitelik dizisi. Bu genellikle uzak bir nesneyi etkinleştirmek için gereken URL'yi belirten tek bir UrlAttribute nesnesi içeren bir dizidir.

Bu parametre istemci tarafından etkinleştirilen nesnelerle ilgilidir. İstemci etkinleştirmesi, geriye dönük uyumluluk için korunan ancak yeni geliştirme için önerilmez eski bir teknolojidir. Dağıtılmış uygulamalar bunun yerine Windows Communication Foundation kullanmalıdır.

Döndürülenler

ObjectHandle

Yeni oluşturulan nesneye erişmek için sarmalanmamış olması gereken bir tanıtıcı veya Nullable<T> örnekleri için null.

Özel durumlar

ArgumentNullException

typeName null.

MissingMethodException

Eşleşen oluşturucu bulunamadı.

TypeLoadException

typeName assemblyFilebulunamadı.

FileNotFoundException

assemblyFile bulunamadı.

MethodAccessException

Çağıranın bu oluşturucuyu çağırma izni yok.

MemberAccessException

Soyut bir sınıfın örneği oluşturulamıyor veya bu üye geç bağlama mekanizmasıyla çağrıldı.

TargetInvocationException

Yansıma aracılığıyla çağrılan oluşturucu bir özel durum oluşturdu.

SecurityException

Çağıranın gerekli FileIOPermissionyok.

NotSupportedException

activationAttributes boş bir dizi değildir ve oluşturulan tür MarshalByRefObjecttüretilmez.

BadImageFormatException

assemblyFile geçerli bir derleme değil.

-veya-

Ortak dil çalışma zamanı (CLR) sürüm 2.0 veya üzeri şu anda yüklüdür ve assemblyFile şu anda yüklü olan sürümden sonraki bir CLR sürümü için derlendi. .NET Framework'ün 2.0, 3.0 ve 3.5 sürümlerinin tümünün CLR sürüm 2.0'ı kullandığını unutmayın.

Açıklamalar

dönüş değerini açmak için ObjectHandle.Unwrap yöntemini kullanın.

Çağrılan yöntemler tarafından oluşturulabilecek diğer özel durumlar hakkında bilgi için Assembly.LoadFrom ve CreateInstance yöntemlerinin Özel Durumlar bölümüne bakın.