Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Activator

 
System_CAPS_noteObservação

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

Contém métodos para criar tipos de objetos localmente ou remotamente, ou obter referências a objetos remotos existentes. Essa classe não pode ser herdada.

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


[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
public sealed class Activator : _Activator

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticCreateComInstanceFrom(String, String)

Cria uma instância do objeto COM cujo nome é especificado, usando o arquivo do assembly nomeado e o construtor padrão.

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

Cria uma instância do objeto COM cujo nome é especificado, usando o arquivo do assembly nomeado e o construtor padrão.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(ActivationContext)

Cria uma instância do tipo designado pelo objeto ActivationContext especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(ActivationContext, String[])

Cria uma instância do tipo que é designada pelo objeto ActivationContext especificado e ativada com os dados de ativação personalizados especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(AppDomain, String, String)

Cria uma instância do tipo, cujo nome é especificado no domínio remoto especificado, usando o assembly nomeado e o construtor padrão.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado usando o assembly nomeado e o construtor que corresponda melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Obsoleto.Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado usando o assembly nomeado e o construtor que corresponda melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(String, String)

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor padrão.

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

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

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

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

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(String, String, Object[])

Cria uma instância do tipo cujo nome é especificado, usando o assembly nomeado e o construtor padrão.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type)

Cria uma instância do tipo especificado usando o construtor padrão do tipo.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo)

Cria uma instância do tipo especificado usando o construtor que corresponde melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo especificado usando o construtor que corresponde melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Boolean)

Cria uma instância do tipo especificado usando o construtor padrão do tipo.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Object[])

Cria uma instância do tipo especificado usando o construtor que corresponde melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance(Type, Object[], Object[])

Cria uma instância do tipo especificado usando o construtor que corresponde melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstance<T>()

Cria uma instância do tipo designado pelo parâmetro de tipo genérico especificado, usando o construtor sem parâmetros.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(AppDomain, String, String)

Cria uma instância do tipo, cujo nome é especificado no domínio remoto especificado, usando o arquivo do assembly nomeado e o construtor padrão.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado usando o arquivo do assembly nomeado e o construtor que corresponda melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Obsoleto.Cria uma instância do tipo cujo nome é especificado no domínio remoto especificado usando o arquivo do assembly nomeado e o construtor que corresponda melhor aos parâmetros especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(String, String)

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

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(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.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Obsoleto.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.

System_CAPS_pubmethodSystem_CAPS_staticCreateInstanceFrom(String, String, Object[])

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

System_CAPS_pubmethodEquals(Object)

Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodSystem_CAPS_staticGetObject(Type, String)

Cria um proxy para o objeto conhecido indicado pelo tipo especificado e pela URL.

System_CAPS_pubmethodSystem_CAPS_staticGetObject(Type, String, Object)

Cria um proxy para o objeto conhecido indicado pelo tipo especificado, URL e dados de canal.

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações do tipo de um objeto, que podem ser usadas para obter informações de tipo para uma interface.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.GetTypeInfoCount(UInt32)

Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Activator.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.

O CreateInstance método cria uma instância de um tipo definido em um assembly ao chamar o construtor que melhor corresponde aos argumentos especificados. Se nenhum argumento for especificado, o construtor sem parâmetros, ou seja, o construtor padrão, é invocado.

Você deve ter permissões suficientes para pesquisar e chamar um construtor; Caso contrário, uma exceção será lançada. Por padrão, somente os construtores públicos são considerados durante a pesquisa de um construtor. Se nenhum construtor ou o construtor padrão pode ser encontrado, uma exceção será lançada.

Um parâmetro de fichário Especifica um objeto que procura um assembly para um construtor adequado. Você pode especificar seus próprios critérios associador e pesquisa. Se Nenhum associador for especificado, um associador padrão será usado. Para obter mais informações, consulte as classes System.Reflection.Binder e System.Reflection.BindingFlags.

Um parâmetro de evidência afeta a política de segurança e permissões para o construtor. Para obter mais informações, consulte a classe System.Security.Policy.Evidence.

Uma instância de um tipo pode ser criada em um site local ou remoto. Se o tipo é criado remotamente, um parâmetro de atributo de ativação Especifica o URI do site remoto. A chamada para criar a instância pode passar por sites intermediários antes de atingir o site remoto. Outros atributos de ativação podem modificar o ambiente, ou no contexto, no qual a chamada opera em sites remotos e intermediários.

Se a instância é criada localmente, uma referência a esse objeto é retornada. Se a instância é criada remotamente, é retornada uma referência a um proxy. O objeto remoto é manipulado por meio do proxy como se fosse um objeto local.

O GetObject método cria um proxy para um objeto remoto em execução no momento, objeto conhecido ativado pelo servidor ou serviço Web XML. Você pode especificar a mídia de conexão, ou seja, o canal. Para obter mais informações, consulte a classe System.Runtime.Remoting.Channels.ChannelServices.

Assemblies contêm definições de tipo. O CreateInstance método cria uma instância de um tipo de um assembly em execução no momento. O CreateInstanceFrom método cria uma instância de um arquivo que contém um assembly. O CreateComInstanceFrom método cria uma instância de um objeto COM de um arquivo que contém um assembly.

O exemplo a seguir mostra como usar o Activator classe para construir dinamicamente os objetos em tempo de execução.

using System;
using System.Reflection;
using System.Text;

public class SomeType
{
    public void DoSomething(int x)
    {
        Console.WriteLine("100 / {0} = {1}", x, 100 / x);
    }
}

public class Example
{
    static void Main()
    {
        // Create an instance of the StringBuilder type using 
        // Activator.CreateInstance.
        Object o = Activator.CreateInstance(typeof(StringBuilder));

        // Append a string into the StringBuilder object and display the 
        // StringBuilder.
        StringBuilder sb = (StringBuilder) o;
        sb.Append("Hello, there.");
        Console.WriteLine(sb);

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

/* This code produces the following output:

Hello, there.
100 / 5 = 20
 */

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: