Activator.CreateComInstanceFrom Método

Definição

Namespace:

System

Assembly:

mscorlib.dll

Cria uma instância do objeto COM cujo nome é especificado.

Sobrecargas

CreateComInstanceFrom(String, String)	Cria uma instância do objeto COM cujo nome é especificado, usando o arquivo de assembly nomeado e o construtor sem parâmetros.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Cria uma instância do objeto COM cujo nome é especificado, usando o arquivo de assembly nomeado e o construtor sem parâmetros.

CreateComInstanceFrom(String, String)

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyName, System::String ^ typeName);

public static System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyName, string typeName);

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

Public Shared Function CreateComInstanceFrom (assemblyName As String, typeName As String) As ObjectHandle

Parâmetros

assemblyName

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 ou assemblyName é null.

TypeLoadException

Uma instância não pode ser criada por meio de COM.

-ou-

typeName não foi encontrado em assemblyName.

MissingMethodException

Nenhum construtor correspondente foi encontrado.

FileNotFoundException

assemblyName não foi encontrado ou o módulo que você está tentando carregar não especifica uma extensão de nome de arquivo.

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.

NotSupportedException

O chamador não pode fornecer atributos de ativação para um objeto que não herda de MarshalByRefObject.

ArgumentException

assemblyName é a cadeia de caracteres vazia ("").

Comentários

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

Um atributo System.Runtime.InteropServices.ComVisibleAttribute com um valor de true deve ser aplicado explicitamente ou por padrão ao tipo COM para que o método CreateComInstanceFrom possa criar uma instância desse tipo; caso contrário, TypeLoadException é gerada.

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.

Nota

A partir do .NET Framework 2.0, esse método poderá ser usado para criar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyName, System::String ^ typeName, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);

public static System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyName, string typeName, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

static member CreateComInstanceFrom : string * string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Runtime.Remoting.ObjectHandle

Public Shared Function CreateComInstanceFrom (assemblyName As String, typeName As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As ObjectHandle

Parâmetros

assemblyName

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.

hashValue

Byte[]

O valor do código hash computado.

hashAlgorithm

AssemblyHashAlgorithm

O algoritmo de hash usado para criar arquivos de hash e gerar o nome forte.

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 ou assemblyName é null.

ArgumentException

assemblyName é a cadeia de caracteres vazia ("").

PathTooLongException

Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.

-ou-

assemblyName é maior que o comprimento máximo definido pelo sistema.

FileNotFoundException

assemblyName não foi encontrado ou o módulo que você está tentando carregar não especifica uma extensão de nome de arquivo.

FileLoadException

assemblyName foi encontrado, mas não pode ser carregado.

BadImageFormatException

assemblyName não é um assembly válido.

SecurityException

Uma base de código que não começa com "file://" foi especificada sem o WebPermissionnecessário.

TypeLoadException

Uma instância não pode ser criada por meio de COM.

-ou-

typeName não foi encontrado em assemblyName.

MissingMethodException

Nenhum construtor correspondente foi encontrado.

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.

NotSupportedException

O chamador não pode fornecer atributos de ativação para um objeto que não herda de MarshalByRefObject.

Comentários

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

Um atributo System.Runtime.InteropServices.ComVisibleAttribute com um valor de true deve ser aplicado explicitamente ou por padrão ao tipo COM para que o método CreateComInstanceFrom possa criar uma instância desse tipo; caso contrário, TypeLoadException é gerada.

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.

Nota

A partir do .NET Framework 2.0, esse método poderá ser usado para criar tipos não públicos se o chamador tiver recebido ReflectionPermission com o sinalizador ReflectionPermissionFlag.RestrictedMemberAccess e se o conjunto de concessões do assembly que contém os tipos não públicos estiver restrito ao conjunto de concessões do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.