Activator.CreateInstanceFrom Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Cria uma instância do tipo cujo nome é especificado, usando o arquivo de assembly nomeado e o construtor que corresponde melhor aos parâmetros especificados.

Sobrecargas

CreateInstanceFrom(String, String, Object[])	Cria uma instância do tipo cujo nome é especificado, usando o arquivo do assembly nomeado e o construtor sem parâmetros.
CreateInstanceFrom(String, String)	Cria uma instância do tipo cujo nome é especificado, usando o arquivo do assembly nomeado e o construtor sem parâmetros.
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Cria uma instância do tipo cujo nome é especificado, usando o arquivo de assembly nomeado e o construtor que corresponde melhor aos parâmetros especificados.

CreateInstanceFrom(String, String, Object[])

Origem:

Activator.cs

Cria uma instância do tipo cujo nome é especificado, usando o arquivo do assembly nomeado e o construtor sem parâmetros.

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

Parâmetros

assemblyFile

String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName

String

O nome do tipo do qual criar uma instância.

activationAttributes

Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

ObjectHandle

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para Nullable<T> instâncias.

Exceções

ArgumentNullException

typeName é null.

MissingMethodException

Nenhum construtor público correspondente foi encontrado.

TypeLoadException

typename não foi encontrado em assemblyFile.

FileNotFoundException

assemblyFile não foi encontrado.

MethodAccessException

O chamador não tem permissão para chamar esse construtor.

MemberAccessException

Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de associação tardia.

TargetInvocationException

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

NotSupportedException

activationAttributes não é uma matriz vazia, e o tipo que está sendo criado não deriva de MarshalByRefObject.

SecurityException

O chamador tem o FileIOPermission necessário.

BadImageFormatException

assemblyFile não é um assembly válido.

- ou -

A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.

Comentários

Use o método ObjectHandle.Unwrap para desencapsular o valor de retorno.

Para obter informações sobre outras exceções que possam ser lançadas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

CreateInstanceFrom(String, String)

Origem:

Activator.cs

Cria uma instância do tipo cujo nome é especificado, usando o arquivo do assembly nomeado e o construtor sem parâmetros.

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

Parâmetros

assemblyFile

String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName

String

O nome do tipo do qual criar uma instância.

Retornos

ObjectHandle

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para Nullable<T> instâncias.

Exceções

ArgumentNullException

typeName é null.

MissingMethodException

Nenhum construtor público correspondente foi encontrado.

TypeLoadException

typename não foi encontrado em assemblyFile.

FileNotFoundException

assemblyFile não foi encontrado.

MethodAccessException

O chamador não tem permissão para chamar esse construtor.

MemberAccessException

Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de associação tardia.

TargetInvocationException

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

SecurityException

O chamador tem o FileIOPermission necessário.

BadImageFormatException

assemblyFile não é um assembly válido.

- ou -

A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.

Exemplos

O exemplo de código a seguir demonstra como chamar o CreateInstanceFrom método . Este exemplo de código faz parte de um exemplo maior fornecido para a Activator classe .

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

Comentários

Use o método ObjectHandle.Unwrap para desencapsular o valor de retorno.

Para obter informações sobre outras exceções que possam ser lançadas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.

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

Origem:

Activator.cs

Cria uma instância do tipo cujo nome é especificado, usando o arquivo de assembly nomeado e o construtor que corresponde melhor aos parâmetros especificados.

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

Parâmetros

assemblyFile

String

O nome de um arquivo que contém um assembly em que o tipo chamado typeName é procurado.

typeName

String

O nome do tipo do qual criar uma instância.

ignoreCase

Boolean

true para especificar que a pesquisa de typeName não diferencia maiúsculas de minúsculas; false para especificar que a pesquisa diferencia maiúsculas de minúsculas.

bindingAttr

BindingFlags

Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName. Caso bindingAttr seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.

binder

Binder

Um objeto que usa bindingAttr e args para buscar e identificar o construtor typeName. Caso binder seja null, o associador padrão é usado.

args

Object[]

Uma matriz de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a ser invocado. Se args for uma matriz vazia ou null, o construtor que não usa nenhum parâmetro (o construtor sem parâmetros) será invocado.

culture

CultureInfo

Informações específicas de cultura que controlam a coerção de args para os tipos formais declarados do construtor typeName. Caso culture seja null, CultureInfo para o thread atual é usado.

activationAttributes

Object[]

Uma matriz de um ou mais atributos que podem participar da ativação. Normalmente, essa é uma matriz que contém um único objeto UrlAttribute que especifica a URL necessária para ativar um objeto remoto.

Esse parâmetro está relacionado a objetos ativados pelo cliente. A ativação do cliente é uma tecnologia herdada, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.

Retornos

ObjectHandle

Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null para Nullable<T> instâncias.

Exceções

ArgumentNullException

typeName é null.

MissingMethodException

Nenhum construtor correspondente foi encontrado.

TypeLoadException

typename não foi encontrado em assemblyFile.

FileNotFoundException

assemblyFile não foi encontrado.

MethodAccessException

O chamador não tem permissão para chamar esse construtor.

MemberAccessException

Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de associação tardia.

TargetInvocationException

O construtor, que foi invocado por meio da reflexão, lançou uma exceção.

SecurityException

O chamador não tem o FileIOPermission necessário.

NotSupportedException

activationAttributes não é uma matriz vazia, e o tipo que está sendo criado não deriva de MarshalByRefObject.

BadImageFormatException

assemblyFile não é um assembly válido.

- ou -

A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.

Comentários

Use o método ObjectHandle.Unwrap para desencapsular o valor de retorno.

Para obter informações sobre outras exceções que possam ser lançadas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.