Método _Assembly.CreateInstance (String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Artigo
04/16/2018

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Fornece objetos COM com acesso independente de versão para o método CreateInstance.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

object CreateInstance(
    string typeName,
    bool ignoreCase,
    BindingFlags bindingAttr,
    Binder binder,
    object[] args,
    CultureInfo culture,
    object[] activationAttributes
)

Object^ CreateInstance(
    String^ typeName,
    bool ignoreCase,
    BindingFlags bindingAttr,
    Binder^ binder,
    array<Object^>^ args,
    CultureInfo^ culture,
    array<Object^>^ activationAttributes
)

abstract CreateInstance : 
        typeName:string *
        ignoreCase:bool *
        bindingAttr:BindingFlags *
        binder:Binder *
        args:Object[] *
        culture:CultureInfo *
        activationAttributes:Object[] -> Object

Function CreateInstance (
    typeName As String,
    ignoreCase As Boolean,
    bindingAttr As BindingFlags,
    binder As Binder,
    args As Object(),
    culture As CultureInfo,
    activationAttributes As Object()
) As Object

Parâmetros

typeName
Type: System.String

O Type.FullName do tipo a se localizar.

ignoreCase
Type: System.Boolean

true para ignorar maiúsculas e minúsculas do nome do tipo; caso contrário, false.

bindingAttr
Type: System.Reflection.BindingFlags

Um bitmask que afeta como a pesquisa é realizada. O valor é uma combinação dos sinalizadores de bit de BindingFlags.

binder
Type: System.Reflection.Binder

Um objeto que permite a associação, a coerção de tipos de argumentos, invocação de membros e a recuperação de objetos MemberInfo por meio de reflexão. Caso binder seja null, o associador padrão é usado.

args
Type: System.Object[]

Uma matriz do tipo Object que contém os argumentos a serem passados ao construtor. Essa matriz de argumentos deve corresponder em número, ordem e tipo aos parâmetros do construtor a ser invocado. Caso haja preferência por um construtor padrão, args deverá ser uma matriz vazia ou null.

culture
Type: System.Globalization.CultureInfo

Uma instância de CultureInfo usada para determinar a coerção de tipos. Se isso for null, será usado o CultureInfo para o thread atual. (Isso é necessário para converter um String que representa 1000 para um valor Double, por exemplo, uma vez que 1000 é representado de forma diferente por diferentes culturas.)

activationAttributes
Type: System.Object[]

Uma matriz do tipo Object que contém um ou mais atributos de ativação que podem participar da ativação. Um exemplo de um atributo de ativação é:

URLAttribute(http://hostname/appname/objectURI)

Valor Retornado

Type: System.Object

Uma instância de Object que representa o tipo e corresponde aos critérios especificados, ou null se typeName não for encontrado.

Comentários

Este método é para acesso a classes gerenciadas de código não gerenciado e não deve ser chamado em código gerenciado.

O CreateInstance método localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador do sistema, com a pesquisa diferencia maiusculas de minúsculas opcional e com a cultura especificada, os argumentos e os atributos de associação e a ativação.

Informações de Versão

.NET Framework
Disponível desde 1.1

Confira Também

CreateInstance
CreateInstance Sobrecarga
Interface _Assembly
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via