AppDomain.CreateComInstanceFrom Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nowe wystąpienie określonego typu COM.

Przeciążenia

CreateComInstanceFrom(String, String)	Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu.

CreateComInstanceFrom(String, String)

Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu.

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

Parametry

assemblyName: String

Nazwa pliku zawierającego zestaw definiujący żądany typ.

typeName: String

Nazwa żądanego typu.

Zwraca

ObjectHandle

Obiekt, który jest otoką dla nowego wystąpienia określonego przez typeName. Aby uzyskać dostęp do rzeczywistego obiektu, należy rozpasać wartość zwracaną.

Wyjątki

ArgumentNullException

assemblyName lub typeName jest null.

TypeLoadException

Nie można załadować typu.

AppDomainUnloadedException

Operacja jest podejmowana w domenie aplikacji, która została zwolniona.

MissingMethodException

Nie znaleziono publicznego konstruktora bez parametrów.

FileNotFoundException

nie można odnaleźć assemblyName.

MemberAccessException

typeName jest klasą abstrakcyjną.

-lub-

Ten element członkowski został wywołany z mechanizmem późnego powiązania.

NotSupportedException

Obiekt wywołujący nie może podać atrybutów aktywacji dla obiektu, który nie dziedziczy z MarshalByRefObject.

ArgumentException

assemblyName jest pustym ciągiem ("").

BadImageFormatException

assemblyName nie jest prawidłowym zestawem.

FileLoadException

Zestaw lub moduł został załadowany dwukrotnie z dwoma różnymi dowodami.

NullReferenceException

Obiekt COM, do którego się odwołuje, jest null.

Przykłady

W poniższym przykładzie pokazano

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

Uwagi

Ta metoda umożliwia zdalne tworzenie obiektów bez konieczności lokalnego ładowania typu.

Wartość zwracana musi być rozpasana, aby uzyskać dostęp do rzeczywistego obiektu.

Atrybut System.Runtime.InteropServices.ComVisibleAttribute z wartością true należy zastosować jawnie lub domyślnie do typu COM dla tej metody, aby utworzyć wystąpienie tego typu; w przeciwnym razie TypeLoadException jest zgłaszany.

Zobacz też

CreateComInstanceFrom(String, String)

Dotyczy

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