Activator.CreateInstanceFrom 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

명명된 어셈블리 파일 및 지정된 매개 변수와 가장 일치하는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.

오버로드

CreateInstanceFrom(String, String, Object[])	명명된 어셈블리 파일 및 매개 변수가 없는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.
CreateInstanceFrom(String, String)	명명된 어셈블리 파일 및 매개 변수가 없는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	명명된 어셈블리 파일 및 지정된 매개 변수와 가장 일치하는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.

CreateInstanceFrom(String, String, Object[])

Source:

Activator.cs

명명된 어셈블리 파일 및 매개 변수가 없는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.

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

매개 변수

assemblyFile

String

이름이 typeName 형식이 검색되는 어셈블리가 포함된 파일의 이름입니다.

typeName

String

인스턴스를 만들 형식의 이름입니다.

activationAttributes

Object[]

활성화에 참여할 수 있는 하나 이상의 특성 배열입니다. 일반적으로 원격 개체를 활성화하는 데 필요한 URL을 지정하는 단일 UrlAttribute 개체가 포함된 배열입니다.

이 매개 변수는 클라이언트 활성화 개체와 관련이 있습니다. 클라이언트 활성화는 이전 버전과의 호환성을 위해 유지되지만 새 개발에는 권장되지 않는 레거시 기술입니다. 분산 애플리케이션은 Windows Communication Foundation을 대신 사용해야 합니다.

반환

ObjectHandle

새로 만든 개체에 액세스하려면 래핑을 해제하거나 Nullable<T> 인스턴스에 대해 null 핸들입니다.

예외

ArgumentNullException

typeName null.

MissingMethodException

일치하는 공용 생성자를 찾을 수 없습니다.

TypeLoadException

assemblyFile typeName 찾을 수 없습니다.

FileNotFoundException

assemblyFile 찾을 수 없습니다.

MethodAccessException

호출자에게 이 생성자를 호출할 수 있는 권한이 없습니다.

MemberAccessException

추상 클래스의 인스턴스를 만들 수 없거나 이 멤버가 런타임에 바인딩 메커니즘을 사용하여 호출되었습니다.

TargetInvocationException

리플렉션을 통해 호출된 생성자는 예외를 throw했습니다.

NotSupportedException

activationAttributes 빈 배열이 아니며 생성되는 형식이 MarshalByRefObject파생되지 않습니다.

SecurityException

호출자에게 필요한 FileIOPermission있습니다.

BadImageFormatException

assemblyFile 유효한 어셈블리가 아닙니다.

-또는-

CLR(공용 언어 런타임) 버전 2.0 이상이 현재 로드되고 assemblyFile 현재 로드된 버전보다 최신인 CLR 버전에 대해 컴파일되었습니다. .NET Framework 버전 2.0, 3.0 및 3.5는 모두 CLR 버전 2.0을 사용합니다.

설명

반환 값을 래프 해제하려면 ObjectHandle.Unwrap 메서드를 사용합니다.

호출된 메서드에서 throw할 수 있는 다른 예외에 대한 자세한 내용은 Assembly.LoadFrom 및 CreateInstance 메서드의 Exceptions 섹션을 참조하세요.

CreateInstanceFrom(String, String)

Source:

Activator.cs

명명된 어셈블리 파일 및 매개 변수가 없는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.

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

매개 변수

assemblyFile

String

이름이 typeName 형식이 검색되는 어셈블리가 포함된 파일의 이름입니다.

typeName

String

인스턴스를 만들 형식의 이름입니다.

반환

ObjectHandle

새로 만든 개체에 액세스하려면 래핑을 해제하거나 Nullable<T> 인스턴스에 대해 null 핸들입니다.

예외

ArgumentNullException

typeName null.

MissingMethodException

일치하는 공용 생성자를 찾을 수 없습니다.

TypeLoadException

assemblyFile typeName 찾을 수 없습니다.

FileNotFoundException

assemblyFile 찾을 수 없습니다.

MethodAccessException

호출자에게 이 생성자를 호출할 수 있는 권한이 없습니다.

MemberAccessException

추상 클래스의 인스턴스를 만들 수 없거나 이 멤버가 런타임에 바인딩 메커니즘을 사용하여 호출되었습니다.

TargetInvocationException

리플렉션을 통해 호출된 생성자는 예외를 throw했습니다.

SecurityException

호출자에게 필요한 FileIOPermission있습니다.

BadImageFormatException

assemblyFile 유효한 어셈블리가 아닙니다.

-또는-

CLR(공용 언어 런타임) 버전 2.0 이상이 현재 로드되고 assemblyFile 현재 로드된 버전보다 최신인 CLR 버전에 대해 컴파일되었습니다. .NET Framework 버전 2.0, 3.0 및 3.5는 모두 CLR 버전 2.0을 사용합니다.

예제

다음 코드 예제에서는 CreateInstanceFrom 메서드를 호출하는 방법을 보여 줍니다. 이 코드 예제는 Activator 클래스에 제공된 더 큰 예제의 일부입니다.

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

설명

반환 값을 래프 해제하려면 ObjectHandle.Unwrap 메서드를 사용합니다.

호출된 메서드에서 throw할 수 있는 다른 예외에 대한 자세한 내용은 Assembly.LoadFrom 및 CreateInstance 메서드의 Exceptions 섹션을 참조하세요.

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

Source:

Activator.cs

명명된 어셈블리 파일 및 지정된 매개 변수와 가장 일치하는 생성자를 사용하여 이름이 지정된 형식의 인스턴스를 만듭니다.

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

매개 변수

assemblyFile

String

이름이 typeName 형식이 검색되는 어셈블리가 포함된 파일의 이름입니다.

typeName

String

인스턴스를 만들 형식의 이름입니다.

ignoreCase

Boolean

typeName 검색이 대/소문자를 구분하지 않도록 지정하는 true. 검색이 대/소문자를 구분하도록 지정하는 false.

bindingAttr

BindingFlags

typeName 생성자에 대한 검색에 영향을 주는 0개 이상의 비트 플래그 조합입니다. bindingAttr 0이면 공용 생성자에 대한 대/소문자 구분 검색이 수행됩니다.

binder

Binder

bindingAttr 및 args 사용하여 typeName 생성자를 검색하고 식별하는 개체입니다. binder null경우 기본 바인더가 사용됩니다.

args

Object[]

호출할 생성자의 매개 변수를 숫자, 순서 및 형식으로 일치시키는 인수의 배열입니다. args 빈 배열 또는 null경우 매개 변수를 사용하지 않는 생성자(매개 변수가 없는 생성자)가 호출됩니다.

culture

CultureInfo

typeName 생성자에 대해 선언된 형식으로 args 강제 변환을 제어하는 문화권별 정보입니다. culture null경우 현재 스레드에 대한 CultureInfo 사용됩니다.

activationAttributes

Object[]

활성화에 참여할 수 있는 하나 이상의 특성 배열입니다. 일반적으로 원격 개체를 활성화하는 데 필요한 URL을 지정하는 단일 UrlAttribute 개체가 포함된 배열입니다.

이 매개 변수는 클라이언트 활성화 개체와 관련이 있습니다. 클라이언트 활성화는 이전 버전과의 호환성을 위해 유지되지만 새 개발에는 권장되지 않는 레거시 기술입니다. 분산 애플리케이션은 Windows Communication Foundation을 대신 사용해야 합니다.

반환

ObjectHandle

새로 만든 개체에 액세스하려면 래핑을 해제하거나 Nullable<T> 인스턴스에 대해 null 핸들입니다.

예외

ArgumentNullException

typeName null.

MissingMethodException

일치하는 생성자를 찾을 수 없습니다.

TypeLoadException

assemblyFile typeName 찾을 수 없습니다.

FileNotFoundException

assemblyFile 찾을 수 없습니다.

MethodAccessException

호출자에게 이 생성자를 호출할 수 있는 권한이 없습니다.

MemberAccessException

추상 클래스의 인스턴스를 만들 수 없거나 이 멤버가 런타임에 바인딩 메커니즘을 사용하여 호출되었습니다.

TargetInvocationException

리플렉션을 통해 호출된 생성자는 예외를 throw했습니다.

SecurityException

호출자에게 필요한 FileIOPermission없습니다.

NotSupportedException

activationAttributes 빈 배열이 아니며 생성되는 형식이 MarshalByRefObject파생되지 않습니다.

BadImageFormatException

assemblyFile 유효한 어셈블리가 아닙니다.

-또는-

CLR(공용 언어 런타임) 버전 2.0 이상이 현재 로드되고 assemblyFile 현재 로드된 버전보다 최신인 CLR 버전에 대해 컴파일되었습니다. .NET Framework 버전 2.0, 3.0 및 3.5는 모두 CLR 버전 2.0을 사용합니다.

설명

반환 값을 래프 해제하려면 ObjectHandle.Unwrap 메서드를 사용합니다.

호출된 메서드에서 throw할 수 있는 다른 예외에 대한 자세한 내용은 Assembly.LoadFrom 및 CreateInstance 메서드의 Exceptions 섹션을 참조하세요.