AppDomain.CreateComInstanceFrom Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea una nuova istanza di un tipo COM specificato.

Overload

CreateComInstanceFrom(String, String)	Crea una nuova istanza di un tipo COM specificato. I parametri specificano il nome di un file che contiene un assembly contenente il tipo e il nome del tipo.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Crea una nuova istanza di un tipo COM specificato. I parametri specificano il nome di un file che contiene un assembly contenente il tipo e il nome del tipo.

CreateComInstanceFrom(String, String)

Crea una nuova istanza di un tipo COM specificato. I parametri specificano il nome di un file che contiene un assembly contenente il tipo e il nome del 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

Parametri

assemblyName: String

Nome di un file contenente un assembly che definisce il tipo richiesto.

typeName: String

Nome del tipo richiesto.

Restituisce

ObjectHandle

Oggetto che è un wrapper per la nuova istanza specificata da typeName. Per accedere all'oggetto reale, è necessario rimuovere il wrapping del valore restituito.

Eccezioni

ArgumentNullException

assemblyName o typeName è null.

TypeLoadException

Impossibile caricare il tipo.

AppDomainUnloadedException

L'operazione viene tentata in un dominio applicazione scaricato.

MissingMethodException

Non è stato trovato alcun costruttore pubblico senza parametri.

FileNotFoundException

assemblyName non viene trovato.

MemberAccessException

typeName è una classe astratta.

-o-

Questo membro è stato richiamato con un meccanismo di associazione tardiva.

NotSupportedException

Il chiamante non può fornire attributi di attivazione per un oggetto che non eredita da MarshalByRefObject.

ArgumentException

assemblyName è una stringa vuota ("").

BadImageFormatException

assemblyName non è un assembly valido.

FileLoadException

Un assembly o un modulo è stato caricato due volte con due prove diverse.

NullReferenceException

L'oggetto COM a cui viene fatto riferimento è null.

Esempio

L'esempio seguente illustra

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

Commenti

Utilizzare questo metodo per creare oggetti in modalità remota senza dover caricare il tipo in locale.

Per accedere all'oggetto reale, è necessario rimuovere il wrapping del valore restituito.

Un attributo System.Runtime.InteropServices.ComVisibleAttribute con valore true deve essere applicato in modo esplicito o per impostazione predefinita al tipo COM per questo metodo per creare un'istanza di tale tipo; in caso contrario, viene generata TypeLoadException.

Vedi anche

CreateComInstanceFrom(String, String)

Si applica a

CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)