AppDomain.CreateComInstanceFrom 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 nova instância de um tipo COM especificado.
Sobrecargas
CreateComInstanceFrom(String, String) |
Cria uma nova instância de um tipo COM especificado. Os parâmetros especificam o nome de um arquivo que contém um assembly que contém o tipo e o nome do tipo. |
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm) |
Cria uma nova instância de um tipo COM especificado. Os parâmetros especificam o nome de um arquivo que contém um assembly que contém o tipo e o nome do tipo. |
CreateComInstanceFrom(String, String)
Cria uma nova instância de um tipo COM especificado. Os parâmetros especificam o nome de um arquivo que contém um assembly que contém o tipo e o nome do tipo.
public:
System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyName, System::String ^ typeName);
public System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyName, string typeName);
member this.CreateComInstanceFrom : string * string -> System.Runtime.Remoting.ObjectHandle
Public Function CreateComInstanceFrom (assemblyName As String, typeName As String) As ObjectHandle
Parâmetros
- assemblyName
- String
O nome de um arquivo que contém um assembly que define o tipo solicitado.
- typeName
- String
O nome do tipo solicitado.
Retornos
Um objeto que é um wrapper para a nova instância especificada por typeName
. O valor retornado precisa ser desembrulhado para acessar o objeto real.
Exceções
assemblyName
ou typeName
é null
.
O tipo não pode ser carregado.
A operação é tentada em um domínio de aplicativo descarregado.
Nenhum construtor público sem parâmetros foi encontrado.
assemblyName
não foi encontrado.
typeName
é uma classe abstrata.
-ou-
Esse membro foi invocado com um mecanismo de associação tardia.
O chamador não pode fornecer atributos de ativação para um objeto que não herda de MarshalByRefObject.
assemblyName
é uma cadeia de caracteres vazia ("").
assemblyName
não é um assembly válido.
Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.
O objeto COM que está sendo referenciado é null
.
Exemplos
O exemplo a seguir demonstra
using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;
[ComVisible(true)]
public ref class MyComVisibleType
{
public:
MyComVisibleType()
{
Console::WriteLine( "MyComVisibleType instantiated!" );
}
};
[ComVisible(false)]
public ref class MyComNonVisibleType
{
public:
MyComNonVisibleType()
{
Console::WriteLine( "MyComNonVisibleType instantiated!" );
}
};
void CreateComInstance( String^ typeName )
{
try
{
AppDomain^ currentDomain = AppDomain::CurrentDomain;
String^ assemblyName = currentDomain->FriendlyName;
currentDomain->CreateComInstanceFrom( assemblyName, typeName );
}
catch ( Exception^ e )
{
Console::WriteLine( e->Message );
}
}
int main()
{
CreateComInstance( "MyComNonVisibleType" ); // Fail!
CreateComInstance( "MyComVisibleType" ); // OK!
}
using System;
using System.Reflection;
using System.Runtime.InteropServices;
[ComVisible(true)]
class MyComVisibleType {
public MyComVisibleType() {
Console.WriteLine("MyComVisibleType instantiated!");
}
}
[ComVisible(false)]
class MyComNonVisibleType {
public MyComNonVisibleType() {
Console.WriteLine("MyComNonVisibleType instantiated!");
}
}
class CreateComInstanceFromSnippet {
public static void Main() {
CreateComInstance("MyComNonVisibleType"); // Fail!
CreateComInstance("MyComVisibleType"); // OK!
}
static void CreateComInstance(string typeName) {
try {
AppDomain currentDomain = AppDomain.CurrentDomain;
string assemblyName = currentDomain.FriendlyName;
currentDomain.CreateComInstanceFrom(assemblyName, typeName);
} catch (Exception e) {
Console.WriteLine(e.Message);
}
}
}
open System
open System.Runtime.InteropServices
[<ComVisible true>]
type MyComVisibleType() =
do
printfn "MyComVisibleType instantiated!"
[<ComVisible false>]
type MyComNonVisibleType() =
do
printfn "MyComNonVisibleType instantiated!"
let createComInstance typeName =
try
let currentDomain = AppDomain.CurrentDomain
let assemblyName = currentDomain.FriendlyName
currentDomain.CreateComInstanceFrom(assemblyName, typeName)
|> ignore
with e ->
printfn $"{e.Message}"
createComInstance "MyComNonVisibleType" // Fail!
createComInstance "MyComVisibleType" // OK!
Imports System.Reflection
Imports System.Runtime.InteropServices
<ComVisible(True)> _
Class MyComVisibleType
Public Sub New()
Console.WriteLine("MyComVisibleType instantiated!")
End Sub
End Class
<ComVisible(False)> _
Class MyComNonVisibleType
Public Sub New()
Console.WriteLine("MyComNonVisibleType instantiated!")
End Sub
End Class
Module Test
Sub Main()
CreateComInstance("MyComNonVisibleType") ' Fail!
CreateComInstance("MyComVisibleType") ' OK!
End Sub
Sub CreateComInstance(typeName As String)
Try
Dim currentDomain As AppDomain = AppDomain.CurrentDomain
Dim assemblyName As String = currentDomain.FriendlyName
currentDomain.CreateComInstanceFrom(assemblyName, typeName)
Catch e As Exception
Console.WriteLine(e.Message)
End Try
End Sub
End Module 'Test
Comentários
Use esse método para criar objetos remotamente sem precisar carregar o tipo localmente.
O valor retornado deve ser desembrulhado para acessar o objeto real.
Um atributo System.Runtime.InteropServices.ComVisibleAttribute com um valor de true
deve ser aplicado explicitamente ou por padrão ao tipo COM desse método para criar uma instância desse tipo; caso contrário, TypeLoadException é gerada.
Confira também
Aplica-se a
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)
Cria uma nova instância de um tipo COM especificado. Os parâmetros especificam o nome de um arquivo que contém um assembly que contém o tipo e o nome do tipo.
public:
System::Runtime::Remoting::ObjectHandle ^ CreateComInstanceFrom(System::String ^ assemblyFile, System::String ^ typeName, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);
public System.Runtime.Remoting.ObjectHandle CreateComInstanceFrom (string assemblyFile, string typeName, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);
member this.CreateComInstanceFrom : string * string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Runtime.Remoting.ObjectHandle
Public Function CreateComInstanceFrom (assemblyFile As String, typeName As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As ObjectHandle
Parâmetros
- assemblyFile
- String
O nome de um arquivo que contém um assembly que define o tipo solicitado.
- typeName
- String
O nome do tipo solicitado.
- hashValue
- Byte[]
Representa o valor do código hash computado.
- hashAlgorithm
- AssemblyHashAlgorithm
Representa o algoritmo de hash usado pelo manifesto do assembly.
Retornos
Um objeto que é um wrapper para a nova instância especificada por typeName
. O valor retornado precisa ser desembrulhado para acessar o objeto real.
Exceções
assemblyFile
ou typeName
é null
.
O tipo não pode ser carregado.
A operação é tentada em um domínio de aplicativo descarregado.
Nenhum construtor público sem parâmetros foi encontrado.
assemblyFile
não foi encontrado.
typeName
é uma classe abstrata.
-ou-
Esse membro foi invocado com um mecanismo de associação tardia.
O chamador não pode fornecer atributos de ativação para um objeto que não herda de MarshalByRefObject.
assemblyFile
é a cadeia de caracteres vazia ("").
assemblyFile
não é um assembly válido.
Um assembly ou módulo foi carregado duas vezes com duas evidências diferentes.
O objeto COM que está sendo referenciado é null
.
Comentários
Use esse método para criar objetos remotamente sem precisar carregar o tipo localmente.
O valor retornado deve ser desembrulhado para acessar o objeto real.
Um atributo System.Runtime.InteropServices.ComVisibleAttribute com um valor de true
deve ser aplicado explicitamente ou por padrão ao tipo COM desse método para criar uma instância desse tipo; caso contrário, TypeLoadException é gerada.