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 corresponde melhor 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 do assembly nomeado e o construtor que corresponda melhor 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 corresponde melhor 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 do assembly nomeado e o construtor que corresponda melhor aos parâmetros especificados. |
CreateInstanceFrom(String, String, Object[]) |
Cria uma instância do tipo cujo nome é especificado, usando o arquivo do 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 do assembly nomeado e o construtor sem parâmetros. |
CreateInstanceFrom(String, String) |
Cria uma instância do tipo cujo nome é especificado, usando o arquivo do 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 corresponde melhor 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 do assembly nomeado e o construtor que corresponda melhor 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
para especificar que a pesquisa de typeName
não diferencia maiúsculas de minúsculas; false
para especificar que a pesquisa diferencia maiúsculas de minúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName
. Caso bindingAttr
seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.
- binder
- Binder
Um objeto que usa bindingAttr
e args
para buscar e identificar o construtor typeName
. Caso binder
seja null
, o associador padrão é usado.
- args
- Object[]
Uma matriz de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a ser invocado. Se args
for uma matriz vazia ou null
, o construtor que não usa nenhum parâmetro (o construtor sem parâmetros) será invocado.
- culture
- CultureInfo
Informações específicas de cultura que controlam a coerção de args
para os tipos formais declarados do construtor typeName
. Caso culture
seja null
, CultureInfo para o thread atual é 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, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.
- securityAttributes
- Evidence
Informações usadas para tomar decisões sobre política de segurança e conceder permissões.
Retornos
Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null
para Nullable<T> instâncias.
- 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 este 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 FileIOPermission necessá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 -
A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName
foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o 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 desencapsular o valor de retorno.
Para obter informações sobre outras exceções que possam ser lançadas 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 corresponde melhor 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
para especificar que a pesquisa de typeName
não diferencia maiúsculas de minúsculas; false
para especificar que a pesquisa diferencia maiúsculas de minúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName
. Caso bindingAttr
seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.
- binder
- Binder
Um objeto que usa bindingAttr
e args
para buscar e identificar o construtor typeName
. Caso binder
seja null
, o associador padrão é usado.
- args
- Object[]
Uma matriz de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a ser invocado. Se args
for uma matriz vazia ou null
, o construtor que não usa nenhum parâmetro (o construtor sem parâmetros) será invocado.
- culture
- CultureInfo
Informações específicas de cultura que controlam a coerção de args
para os tipos formais declarados do construtor typeName
. Caso culture
seja null
, CultureInfo para o thread atual é 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, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. Em vez disso, os aplicativos distribuídos devem usar o Windows Communication Foundation.
- securityInfo
- Evidence
Informações usadas para tomar decisões sobre política de segurança e conceder permissões.
Retornos
Um identificador que deve ser desembrulhado para acessar o objeto recém-criado ou null
para Nullable<T> instâncias.
- 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 este 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 FileIOPermission necessá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 -
A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName
foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.
Comentários
Use o método ObjectHandle.Unwrap para desencapsular o valor de retorno.
Para obter informações sobre outras exceções que possam ser lançadas 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 do assembly nomeado e o construtor que corresponda melhor 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
para especificar que a pesquisa de typeName
não diferencia maiúsculas de minúsculas; false
para especificar que a pesquisa diferencia maiúsculas de minúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName
. Caso bindingAttr
seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.
- binder
- Binder
Um objeto que usa bindingAttr
e args
para buscar e identificar o construtor typeName
. Caso binder
seja null
, o associador padrão é usado.
- args
- Object[]
Uma matriz de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a ser invocado. Se args
for uma matriz vazia ou null
, o construtor que não usa nenhum parâmetro (o construtor sem parâmetros) será invocado.
- culture
- CultureInfo
Informações específicas de cultura que controlam a coerção de args
para os tipos formais declarados do construtor typeName
. Caso culture
seja null
, CultureInfo para o thread atual é 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, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. 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 Nullable<T> instâncias.
- 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 este 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 FileIOPermission necessá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 -
assemblyName
foi compilado para uma versão do Common Language Runtime posterior à versão que 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 desencapsular o valor de retorno.
Para obter informações sobre outras exceções que podem ser geradas por métodos invocados, consulte as seções Exceções dos Assembly.LoadFrom métodos 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 do 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, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. 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 Nullable<T> instâncias.
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 este 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 FileIOPermission necessário.
assemblyFile
não é um assembly válido.
- ou -
A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName
foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.
Comentários
Use o método ObjectHandle.Unwrap para desencapsular o valor de retorno.
Para obter informações sobre outras exceções que possam ser lançadas 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 do 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 Nullable<T> instâncias.
- 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 este 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 FileIOPermission necessário.
assemblyFile
não é um assembly válido.
- ou -
A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName
foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o 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 desencapsular o valor de retorno.
Para obter informações sobre outras exceções que possam ser lançadas 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 do 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 Nullable<T> instâncias.
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 este 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 FileIOPermission necessário.
assemblyFile
não é um assembly válido.
- ou -
A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName
foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.
Exemplos
O exemplo de código a seguir 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,
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 desencapsular o valor de retorno.
Para obter informações sobre outras exceções que possam ser lançadas 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 corresponde melhor 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
para especificar que a pesquisa de typeName
não diferencia maiúsculas de minúsculas; false
para especificar que a pesquisa diferencia maiúsculas de minúsculas.
- bindingAttr
- BindingFlags
Uma combinação de zero ou mais sinalizadores de bit que afetam a pesquisa do construtor typeName
. Caso bindingAttr
seja zero, uma pesquisa que diferencia maiúsculas de minúsculas para construtores públicos é realizada.
- binder
- Binder
Um objeto que usa bindingAttr
e args
para buscar e identificar o construtor typeName
. Caso binder
seja null
, o associador padrão é usado.
- args
- Object[]
Uma matriz de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a ser invocado. Se args
for uma matriz vazia ou null
, o construtor que não usa nenhum parâmetro (o construtor sem parâmetros) será invocado.
- culture
- CultureInfo
Informações específicas de cultura que controlam a coerção de args
para os tipos formais declarados do construtor typeName
. Caso culture
seja null
, CultureInfo para o thread atual é 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, mantida para compatibilidade com versões anteriores, mas não é recomendada para novos desenvolvimentos. 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 Nullable<T> instâncias.
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 este 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 FileIOPermission necessá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 -
A versão 2.0 do Common Language Runtime (CLR) ou posterior é carregado no momento, e assemblyName
foi compilado para uma versão do CLR posterior à versão carregada atualmente. Todas as versões do .NET Framework 2.0, 3.0 e 3.5 usam o CLR versão 2.0.
Comentários
Use o método ObjectHandle.Unwrap para desencapsular o valor de retorno.
Para obter informações sobre outras exceções que possam ser lançadas por métodos invocados, consulte a seção Exceções dos métodos Assembly.LoadFrom e CreateInstance.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de