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 melhor corresponde aos parâmetros especificados.

Sobrecargas

CreateInstanceFrom(String, String, Object[])	Cria uma instância do tipo cujo nome é especificado, usando o arquivo de assembly nomeado e o construtor sem parâmetros.
CreateInstanceFrom(String, String)	Cria uma instância do tipo cujo nome é especificado, usando o arquivo de 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 melhor corresponde aos parâmetros especificados.

CreateInstanceFrom(String, String, Object[])

Origem:

Activator.cs

Cria uma instância do tipo cujo nome é especificado, usando o arquivo de 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 que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. 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 instâncias de Nullable<T>.

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 esse 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 FileIOPermissionnecessário.

BadImageFormatException

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Comentários

Use o método ObjectHandle.Unwrap para desembrulhar o valor retornado.

Para obter informações sobre outras exceções que podem ser geradas 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 de 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 instâncias de Nullable<T>.

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 esse 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 FileIOPermissionnecessário.

BadImageFormatException

assemblyFile não é um assembly válido.

-ou-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Exemplos

O exemplo de código a seguir demonstra como chamar o método CreateInstanceFrom. Este exemplo de código faz parte de um exemplo maior fornecido para a classe 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)

Comentários

Use o método ObjectHandle.Unwrap para desembrulhar o valor retornado.

Para obter informações sobre outras exceções que podem ser geradas 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 melhor corresponde 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 especificar que a pesquisa por typeName não diferencia maiúsculas de minúsculas; false especificar que a pesquisa diferencia maiúsculas de minúsculas.

bindingAttr

BindingFlags

Uma combinação de sinalizadores de zero ou mais bits que afetam a pesquisa do construtor typeName. Se bindingAttr for zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos será realizada.

binder

Binder

Um objeto que usa bindingAttr e args para procurar e identificar o construtor typeName. Se binder for null, o associador padrão será usado.

args

Object[]

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

culture

CultureInfo

Informações específicas da cultura que regem a coerção de args aos tipos formais declarados para o construtor typeName. Se culture for null, o CultureInfo do thread atual será 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 que é retida para compatibilidade com versões anteriores, mas não é recomendada para o novo desenvolvimento. 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 instâncias de Nullable<T>.

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 esse 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 FileIOPermissionnecessá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-

O CLR (Common Language Runtime) versão 2.0 ou posterior está carregado no momento e assemblyFile foi compilado para uma versão do CLR posterior à versão carregada no momento. Observe que as versões do .NET Framework 2.0, 3.0 e 3.5 usam clr versão 2.0.

Comentários

Use o método ObjectHandle.Unwrap para desembrulhar o valor retornado.

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