Activator.CreateInstanceFrom Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.ObjectHandlePublic 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 ObjectHandleParâ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.ObjectHandlePublic 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 ObjectHandleParâ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.ObjectHandlePublic 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 ObjectHandleParâ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.ObjectHandlePublic Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String, activationAttributes As Object()) As ObjectHandleParâ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.ObjectHandlePublic Shared Function CreateInstanceFrom (domain As AppDomain, assemblyFile As String, typeName As String) As ObjectHandleParâ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.ObjectHandlePublic Shared Function CreateInstanceFrom (assemblyFile As String, typeName As String) As ObjectHandleParâ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.ObjectHandlePublic 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 ObjectHandleParâ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.
