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

Adlı türün arandığı derlemeyi içeren dosyanın adı typeName .

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 nesneyi etkinleştirmek için gereken URL'yi belirten tek UrlAttribute bir nesne 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 veya null örneklere erişmek için Nullable<T> eşlenmemiş olması gereken bir tanıtıcı.

Özel durumlar

ArgumentNullException

typeName, null değeridir.

MissingMethodException

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

TypeLoadException

typename içinde assemblyFilebulunamadı.

FileNotFoundException

assemblyFile bulunamadı.

MethodAccessException

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

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'den MarshalByRefObjecttüretilmez.

SecurityException

Çağıranın gerekli öğesine sahip olması gerekir FileIOPermission.

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 assemblyName şu anda yüklü olan sürümden sonraki bir CLR sürümü için derlendi. .NET Framework 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

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

Çağrılan yöntemler tarafından oluşturulabilecek diğer özel durumlar hakkında bilgi için ve CreateInstance yöntemlerinin Assembly.LoadFrom Ö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

Adlı türün arandığı derlemeyi içeren dosyanın adı typeName .

typeName

String

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

Döndürülenler

ObjectHandle

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

Özel durumlar

ArgumentNullException

typeName, null değeridir.

MissingMethodException

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

TypeLoadException

typename içinde assemblyFilebulunamadı.

FileNotFoundException

assemblyFile bulunamadı.

MethodAccessException

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

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 öğesine sahip olması gerekir FileIOPermission.

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 assemblyName şu anda yüklü olan sürümden sonraki bir CLR sürümü için derlendi. .NET Framework 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, yönteminin nasıl çağrılduğunu CreateInstanceFrom gösterir. Bu kod örneği, sınıfı için Activator 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

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

Çağrılan yöntemler tarafından oluşturulabilecek diğer özel durumlar hakkında bilgi için ve CreateInstance yöntemlerinin Assembly.LoadFrom Ö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

Adlı türün arandığı derlemeyi içeren dosyanın adı typeName .

typeName

String

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

ignoreCase

Boolean

truearamasının büyük/küçük harfe duyarlı olmadığını belirtmek için; false aramanın büyük/küçük harfe duyarlı olduğunu belirtmek içintypeName.

bindingAttr

BindingFlags

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

binder

Binder

Oluşturucuyu aramak ve tanımlamak typeName için ve args kullanan bindingAttr bir nesne. ise bindernull, 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. boş bir dizi veya nulliseargs, parametre alan oluşturucu (parametresiz oluşturucu) çağrılır.

culture

CultureInfo

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

activationAttributes

Object[]

Etkinleştirmeye katılabilen bir veya daha fazla öznitelik dizisi. Bu genellikle uzak nesneyi etkinleştirmek için gereken URL'yi belirten tek UrlAttribute bir nesne 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 veya null örneklere erişmek için Nullable<T> eşlenmemiş olması gereken bir tanıtıcı.

Özel durumlar

ArgumentNullException

typeName, null değeridir.

MissingMethodException

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

TypeLoadException

typename içinde assemblyFilebulunamadı.

FileNotFoundException

assemblyFile bulunamadı.

MethodAccessException

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

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'den 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 assemblyName şu anda yüklü olan sürümden sonraki bir CLR sürümü için derlendi. .NET Framework 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

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

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