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, który definiuje żądany typ.

typeName: String

Nazwa żądanego typu.

Zwraca

ObjectHandle

Obiekt, który jest otoką dla nowego wystąpienia określonego przez typeName. Zwracana wartość musi być bez otoki, aby miała dostęp do rzeczywistego obiektu.

Wyjątki

ArgumentNullException

assemblyName lub typeName to null.

TypeLoadException

Nie można załadować typu.

AppDomainUnloadedException

Próba wykonania operacji w niezaładowanej domenie aplikacji.

MissingMethodException

Nie znaleziono publicznego konstruktora bez parametrów.

FileNotFoundException

assemblyName nie można odnaleźć.

MemberAccessException

typeName jest klasą abstrakcyjną.

-lub-

Ten element członkowski został wywołany z użyciem mechanizmu opóźnionego wiązania.

NotSupportedException

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

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 jest odwoływany, to 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 Test {
   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 zostać rozpasana, aby uzyskać dostęp do rzeczywistego obiektu.

Atrybut System.Runtime.InteropServices.ComVisibleAttribute o wartości true musi być stosowany jawnie lub domyślnie do typu COM dla tej metody w celu utworzenia wystąpienia tego typu; w przeciwnym razie TypeLoadException jest zgłaszany.

Zobacz też

CreateComInstanceFrom(String, String)

Dotyczy

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.

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

Parametry

assemblyFile: String

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

typeName: String

Nazwa żądanego typu.

hashValue: Byte[]

Reprezentuje wartość obliczonego kodu skrótu.

hashAlgorithm: AssemblyHashAlgorithm

Reprezentuje algorytm skrótu używany przez manifest zestawu.

Zwraca

ObjectHandle

Obiekt, który jest otoką dla nowego wystąpienia określonego przez typeName. Zwracana wartość musi być bez otoki, aby miała dostęp do rzeczywistego obiektu.