Partilhar via


Activator.CreateInstanceFrom Método

Definição

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(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 de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

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

CreateInstanceFrom(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 de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

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(AppDomain, String, String)

Cria uma instância do tipo cujo nome é especificado no domínio remoto 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(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)

Cuidado

Methods which use Evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, 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, System::Security::Policy::Evidence ^ securityAttributes);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);
[System.Obsolete("Methods which use Evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes, System.Security.Policy.Evidence securityAttributes);
static member CreateInstanceFrom : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
[<System.Obsolete("Methods which use Evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
[<System.Security.SecurityCritical>]
static member CreateInstanceFrom : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (domain As AppDomain, assemblyFile As String, typeName As String, ignoreCase As Boolean, bindingAttr As BindingFlags, binder As Binder, args As Object(), culture As CultureInfo, activationAttributes As Object(), securityAttributes As Evidence) As ObjectHandle

Parâmetros

domain
AppDomain

O domínio remoto em que o tipo chamado typeName é criado.

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.

securityAttributes
Evidence

Informações usadas para tomar decisões de política de segurança e conceder permissões de código.

Retornos

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

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

O chamador tem o FileIOPermissionnecessário.

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

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 CreateInstanceFrom quando um host precisar executar código em um domínio de aplicativo que tenha permissões de segurança restritas.

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.

Aplica-se a

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

Cuidado

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

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, System::Security::Policy::Evidence ^ securityInfo);
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, System.Security.Policy.Evidence securityInfo);
[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
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, System.Security.Policy.Evidence securityInfo);
static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> System.Runtime.Remoting.ObjectHandle
[<System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of CreateInstanceFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member CreateInstanceFrom : string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] * System.Security.Policy.Evidence -> 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(), securityInfo As Evidence) 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.

securityInfo
Evidence

Informações usadas para tomar decisões de política de segurança e conceder permissões de código.

Retornos

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

Atributos

Exceções

typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

O chamador não tem o FileIOPermissionnecessário.

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

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.

Aplica-se a

CreateInstanceFrom(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 de assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, 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);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName, bool ignoreCase, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, object[] args, System.Globalization.CultureInfo culture, object[] activationAttributes);
[<System.Security.SecurityCritical>]
static member CreateInstanceFrom : AppDomain * string * string * bool * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo * obj[] -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (domain As AppDomain, 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

domain
AppDomain

O domínio remoto em que o tipo chamado typeName é criado.

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

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

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

O chamador tem o FileIOPermissionnecessário.

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

assemblyFile não é um assembly válido.

-ou-

assemblyFile foi compilado para uma versão do common language runtime que é posterior à versão carregada no momento.

Comentários

Use CreateInstanceFrom quando um host precisar executar código em um domínio de aplicativo que tenha permissões de segurança restritas.

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 as seções Exceções dos métodos Assembly.LoadFrom e CreateInstance.

Aplica-se a

CreateInstanceFrom(String, String, Object[])

Origem:
Activator.cs
Origem:
Activator.cs
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);
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

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

Exceções

typeName é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

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

O chamador tem o FileIOPermissionnecessário.

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.

Aplica-se a

CreateInstanceFrom(AppDomain, String, String)

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

public:
 static System::Runtime::Remoting::ObjectHandle ^ CreateInstanceFrom(AppDomain ^ domain, System::String ^ assemblyFile, System::String ^ typeName);
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName);
[System.Security.SecurityCritical]
public static System.Runtime.Remoting.ObjectHandle CreateInstanceFrom (AppDomain domain, string assemblyFile, string typeName);
static member CreateInstanceFrom : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
[<System.Security.SecurityCritical>]
static member CreateInstanceFrom : AppDomain * string * string -> System.Runtime.Remoting.ObjectHandle
Public Shared Function CreateInstanceFrom (domain As AppDomain, assemblyFile As String, typeName As String) As ObjectHandle

Parâmetros

domain
AppDomain

O domínio remoto em que o tipo chamado typeName é criado.

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

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

Atributos

Exceções

domain ou typeName é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

O chamador tem o FileIOPermissionnecessário.

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 CreateInstanceFrom quando um host precisar executar código em um domínio de aplicativo que tenha permissões de segurança restritas.

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.

Aplica-se a

CreateInstanceFrom(String, String)

Origem:
Activator.cs
Origem:
Activator.cs
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);
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

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

Exceções

typeName é null.

Nenhum construtor público correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

O chamador tem o FileIOPermissionnecessário.

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.

Aplica-se a

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

Origem:
Activator.cs
Origem:
Activator.cs
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);
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

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

Exceções

typeName é null.

Nenhum construtor correspondente foi encontrado.

typeName não foi encontrado em assemblyFile.

assemblyFile não foi encontrado.

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

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

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

O chamador não tem o FileIOPermissionnecessário.

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

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.

Aplica-se a