Activator.CreateInstanceFrom Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma instância do tipo cujo nome é especificado, usando o ficheiro assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados.
Sobrecargas
| Name | Description |
|---|---|
| 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 ficheiro 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 ficheiro 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 ficheiro 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 ficheiro 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 ficheiro assembly nomeado e o construtor sem parâmetros. |
| CreateInstanceFrom(String, String) |
Cria uma instância do tipo cujo nome é especificado, usando o ficheiro 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 ficheiro assembly nomeado e o construtor que melhor corresponde aos parâmetros especificados. |
CreateInstanceFrom(AppDomain, String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Atenção
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 ficheiro 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 onde o tipo nomeado typeName é criado.
- assemblyFile
- String
O nome de um ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
- ignoreCase
- Boolean
true para especificar que a pesquisa por typeName não é sensível a maiúsculas minúsculas; false para especificar que a pesquisa é sensível a maiúsculas e maiúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais flags de bits que afetam a pesquisa pelo typeName construtor. Se bindingAttr for zero, é realizada uma pesquisa sensível a maiúsculas minúsculas por construtores públicos.
- binder
- Binder
Um objeto que usa, bindingAttrargs procura e identifica o typeName construtor. Se binder for null, utiliza-se o dossier padrão.
- args
- Object[]
Um array de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a invocar. Se args for um array vazio ou null, o construtor que não toma parâmetros (o construtor sem parâmetros) é invocado.
- culture
- CultureInfo
Informação específica da cultura que governa a coerção dos args tipos formais declarados para o typeName construtor. Se culture for null, é usado o CultureInfo para a thread atual.
- activationAttributes
- Object[]
Um conjunto de um ou mais atributos que podem participar na ativação. Normalmente, trata-se de um array que contém um único UrlAttribute objeto que especifica a URL necessária para ativar um objeto remoto.
Este parâmetro está relacionado com objetos ativados pelo cliente. A ativação por clientes é uma tecnologia legada que é mantida para compatibilidade retroativa, mas não é recomendada para novos desenvolvimentos. As aplicações distribuídas deveriam antes usar o Windows Communication Foundation.
- securityAttributes
- Evidence
Informação usada para tomar decisões sobre políticas de segurança e conceder permissões de código.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
- Atributos
Exceções
domain ou typeName é null.
Não foi encontrado nenhum construtor correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
O interlocutor tem o requisito FileIOPermissionde .
activationAttributes não é um array vazio, e o tipo criado não deriva de MarshalByRefObject.
assemblyFile não é uma assembleia válida.
-ou-
A versão 2.0 ou posterior do common language runtime (CLR) está atualmente carregada e assemblyFile foi compilada para uma versão do CLR posterior à versão atualmente carregada. Note que as versões 2.0, 3.0 e 3.5 do .NET Framework usam todas a versão 2.0 do CLR.
Observações
Use CreateInstanceFrom quando um host precisa de executar código num domínio de aplicação que tem permissões de segurança restritas.
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte a secção Exceptions dos Assembly.LoadFrom métodos e CreateInstance .
Aplica-se a
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[], Evidence)
Atenção
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 ficheiro 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 ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
- ignoreCase
- Boolean
true para especificar que a pesquisa por typeName não é sensível a maiúsculas minúsculas; false para especificar que a pesquisa é sensível a maiúsculas e maiúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais flags de bits que afetam a pesquisa pelo typeName construtor. Se bindingAttr for zero, é realizada uma pesquisa sensível a maiúsculas minúsculas por construtores públicos.
- binder
- Binder
Um objeto que usa, bindingAttrargs procura e identifica o typeName construtor. Se binder for null, utiliza-se o dossier padrão.
- args
- Object[]
Um array de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a invocar. Se args for um array vazio ou null, o construtor que não toma parâmetros (o construtor sem parâmetros) é invocado.
- culture
- CultureInfo
Informação específica da cultura que governa a coerção dos args tipos formais declarados para o typeName construtor. Se culture for null, é usado o CultureInfo para a thread atual.
- activationAttributes
- Object[]
Um conjunto de um ou mais atributos que podem participar na ativação. Normalmente, trata-se de um array que contém um único UrlAttribute objeto que especifica a URL necessária para ativar um objeto remoto.
Este parâmetro está relacionado com objetos ativados pelo cliente. A ativação por clientes é uma tecnologia legada que é mantida para compatibilidade retroativa, mas não é recomendada para novos desenvolvimentos. As aplicações distribuídas deveriam antes usar o Windows Communication Foundation.
- securityInfo
- Evidence
Informação usada para tomar decisões sobre políticas de segurança e conceder permissões de código.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
- Atributos
Exceções
typeName é null.
Não foi encontrado nenhum construtor correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
O chamador não tem o requisito FileIOPermissionde .
activationAttributes não é um array vazio, e o tipo criado não deriva de MarshalByRefObject.
assemblyFile não é uma assembleia válida.
-ou-
A versão 2.0 ou posterior do common language runtime (CLR) está atualmente carregada e assemblyFile foi compilada para uma versão do CLR posterior à versão atualmente carregada. Note que as versões 2.0, 3.0 e 3.5 do .NET Framework usam todas a versão 2.0 do CLR.
Observações
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte a secção Exceptions dos Assembly.LoadFrom métodos 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 ficheiro 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 onde o tipo nomeado typeName é criado.
- assemblyFile
- String
O nome de um ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
- ignoreCase
- Boolean
true para especificar que a pesquisa por typeName não é sensível a maiúsculas minúsculas; false para especificar que a pesquisa é sensível a maiúsculas e maiúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais flags de bits que afetam a pesquisa pelo typeName construtor. Se bindingAttr for zero, é realizada uma pesquisa sensível a maiúsculas minúsculas por construtores públicos.
- binder
- Binder
Um objeto que usa, bindingAttrargs procura e identifica o typeName construtor. Se binder for null, utiliza-se o dossier padrão.
- args
- Object[]
Um array de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a invocar. Se args for um array vazio ou null, o construtor que não toma parâmetros (o construtor sem parâmetros) é invocado.
- culture
- CultureInfo
Informação específica da cultura que governa a coerção dos args tipos formais declarados para o typeName construtor. Se culture for null, é usado o CultureInfo para a thread atual.
- activationAttributes
- Object[]
Um conjunto de um ou mais atributos que podem participar na ativação. Normalmente, trata-se de um array que contém um único UrlAttribute objeto que especifica a URL necessária para ativar um objeto remoto.
Este parâmetro está relacionado com objetos ativados pelo cliente. A ativação por clientes é uma tecnologia legada que é mantida para compatibilidade retroativa, mas não é recomendada para novos desenvolvimentos. As aplicações distribuídas deveriam antes usar o Windows Communication Foundation.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
- Atributos
Exceções
domain ou typeName é null.
Não foi encontrado nenhum construtor correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
O interlocutor tem o requisito FileIOPermissionde .
activationAttributes não é um array vazio, e o tipo criado não deriva de MarshalByRefObject.
assemblyFile não é uma assembleia válida.
-ou-
assemblyFile foi compilado para uma versão do runtime da linguagem comum que é posterior à versão atualmente carregada.
Observações
Use CreateInstanceFrom quando um host precisa de executar código num domínio de aplicação que tem permissões de segurança restritas.
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte as secções Exceções dos Assembly.LoadFrom métodos e CreateInstance .
Aplica-se a
CreateInstanceFrom(String, String, Object[])
Cria uma instância do tipo cujo nome é especificado, usando o ficheiro 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);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 ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
- activationAttributes
- Object[]
Um conjunto de um ou mais atributos que podem participar na ativação. Normalmente, trata-se de um array que contém um único UrlAttribute objeto que especifica a URL necessária para ativar um objeto remoto.
Este parâmetro está relacionado com objetos ativados pelo cliente. A ativação por clientes é uma tecnologia legada que é mantida para compatibilidade retroativa, mas não é recomendada para novos desenvolvimentos. As aplicações distribuídas deveriam antes usar o Windows Communication Foundation.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
Exceções
typeName é null.
Não foi encontrado nenhum construtor público correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
activationAttributes não é um array vazio, e o tipo criado não deriva de MarshalByRefObject.
O interlocutor tem o requisito FileIOPermissionde .
assemblyFile não é uma assembleia válida.
-ou-
A versão 2.0 ou posterior do common language runtime (CLR) está atualmente carregada e assemblyFile foi compilada para uma versão do CLR posterior à versão atualmente carregada. Note que as versões 2.0, 3.0 e 3.5 do .NET Framework usam todas a versão 2.0 do CLR.
Observações
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte a secção Exceptions dos Assembly.LoadFrom métodos 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 ficheiro 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 onde o tipo nomeado typeName é criado.
- assemblyFile
- String
O nome de um ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
- Atributos
Exceções
domain ou typeName é null.
Não foi encontrado nenhum construtor público correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
O interlocutor tem o requisito FileIOPermissionde .
assemblyFile não é uma assembleia válida.
-ou-
A versão 2.0 ou posterior do common language runtime (CLR) está atualmente carregada e assemblyFile foi compilada para uma versão do CLR posterior à versão atualmente carregada. Note que as versões 2.0, 3.0 e 3.5 do .NET Framework usam todas a versão 2.0 do CLR.
Observações
Use CreateInstanceFrom quando um host precisa de executar código num domínio de aplicação que tem permissões de segurança restritas.
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte a secção Exceptions dos Assembly.LoadFrom métodos e CreateInstance .
Aplica-se a
CreateInstanceFrom(String, String)
Cria uma instância do tipo cujo nome é especificado, usando o ficheiro 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);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 ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
Exceções
typeName é null.
Não foi encontrado nenhum construtor público correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
O interlocutor tem o requisito FileIOPermissionde .
assemblyFile não é uma assembleia válida.
-ou-
A versão 2.0 ou posterior do common language runtime (CLR) está atualmente carregada e assemblyFile foi compilada para uma versão do CLR posterior à versão atualmente carregada. Note que as versões 2.0, 3.0 e 3.5 do .NET Framework usam todas a versão 2.0 do CLR.
Exemplos
O seguinte exemplo de código demonstra como chamar o CreateInstanceFrom método. Este exemplo de código faz parte de um exemplo maior fornecido para a Activator classe.
// 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)
Observações
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte a secção Exceptions dos Assembly.LoadFrom métodos e CreateInstance .
Aplica-se a
CreateInstanceFrom(String, String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])
Cria uma instância do tipo cujo nome é especificado, usando o ficheiro 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);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 ficheiro que contém uma assembleia onde se procura o tipo nomeado typeName .
- typeName
- String
O nome do tipo a criar uma instância de.
- ignoreCase
- Boolean
true para especificar que a pesquisa por typeName não é sensível a maiúsculas minúsculas; false para especificar que a pesquisa é sensível a maiúsculas e maiúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais flags de bits que afetam a pesquisa pelo typeName construtor. Se bindingAttr for zero, é realizada uma pesquisa sensível a maiúsculas minúsculas por construtores públicos.
- binder
- Binder
Um objeto que usa, bindingAttrargs procura e identifica o typeName construtor. Se binder for null, utiliza-se o dossier padrão.
- args
- Object[]
Um array de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a invocar. Se args for um array vazio ou null, o construtor que não toma parâmetros (o construtor sem parâmetros) é invocado.
- culture
- CultureInfo
Informação específica da cultura que governa a coerção dos args tipos formais declarados para o typeName construtor. Se culture for null, é usado o CultureInfo para a thread atual.
- activationAttributes
- Object[]
Um conjunto de um ou mais atributos que podem participar na ativação. Normalmente, trata-se de um array que contém um único UrlAttribute objeto que especifica a URL necessária para ativar um objeto remoto.
Este parâmetro está relacionado com objetos ativados pelo cliente. A ativação por clientes é uma tecnologia legada que é mantida para compatibilidade retroativa, mas não é recomendada para novos desenvolvimentos. As aplicações distribuídas deveriam antes usar o Windows Communication Foundation.
Devoluções
Um handle que deve ser desdobrado para aceder ao objeto recém-criado, ou null para Nullable<T> instâncias.
Exceções
typeName é null.
Não foi encontrado nenhum construtor correspondente.
typeName não foi encontrado em assemblyFile.
assemblyFile não foi encontrado.
O chamador não tem permissão para chamar este construtor.
Não é possível criar uma instância de uma classe abstrata, ou este membro foi invocado com um mecanismo de ligação tardia.
O construtor, que foi invocado através da reflexão, lançou uma exceção.
O chamador não tem o requisito FileIOPermissionde .
activationAttributes não é um array vazio, e o tipo criado não deriva de MarshalByRefObject.
assemblyFile não é uma assembleia válida.
-ou-
A versão 2.0 ou posterior do common language runtime (CLR) está atualmente carregada e assemblyFile foi compilada para uma versão do CLR posterior à versão atualmente carregada. Note que as versões 2.0, 3.0 e 3.5 do .NET Framework usam todas a versão 2.0 do CLR.
Observações
Use o ObjectHandle.Unwrap método para desembrulhar o valor de retorno.
Para informações sobre outras exceções que podem ser lançadas por métodos invocados, consulte a secção Exceptions dos Assembly.LoadFrom métodos e CreateInstance .