AppDomain.CreateComInstanceFrom Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: mscorlib.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen COM türünün yeni bir örneğini oluşturur.

Aşırı Yüklemeler

CreateComInstanceFrom(String, String)	Belirtilen COM türünün yeni bir örneğini oluşturur. Parametreler, türü ve türünü içeren bir derleme içeren dosyanın adını belirtir.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Belirtilen COM türünün yeni bir örneğini oluşturur. Parametreler, türü ve türünü içeren bir derleme içeren dosyanın adını belirtir.

CreateComInstanceFrom(String, String)

Belirtilen COM türünün yeni bir örneğini oluşturur. Parametreler, türü ve türünü içeren bir derleme içeren dosyanın adını belirtir.

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

Parametreler

assemblyName: String

İstenen türü tanımlayan bir derleme içeren dosyanın adı.

typeName: String

İstenen türün adı.

Döndürülenler

ObjectHandle

tarafından typeNamebelirtilen yeni örnek için sarmalayıcı olan bir nesne. Gerçek nesneye erişmek için, dönüş değerinin sarmalanmış halden çıkarılması gerekir.

Özel durumlar

ArgumentNullException

assemblyName veya typeName şeklindedir null.

TypeLoadException

Tür yüklenemiyor.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

MissingMethodException

Genel parametresiz oluşturucu bulunamadı.

FileNotFoundException

assemblyName bulunamadı.

MemberAccessException

typeName soyut bir sınıftır.

-veya-

Bu üye bir geç bağlanma mekanizması ile çağrıldı.

NotSupportedException

Çağıran, öğesinden MarshalByRefObjectdevralmayan bir nesne için etkinleştirme öznitelikleri sağlayamaz.

ArgumentException

assemblyName boş bir dizedir ("").

BadImageFormatException

assemblyName geçerli bir derleme değil.

FileLoadException

Bir derleme veya modül iki farklı kanıtla iki kez yüklendi.

NullReferenceException

Başvurulmakta olan COM nesnesi şeklindedir null.

Örnekler

Aşağıdaki örnek,

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

Açıklamalar

Türü yerel olarak yüklemek zorunda kalmadan nesneleri uzaktan oluşturmak için bu yöntemi kullanın.

Gerçek nesneye erişmek için dönüş değerinin sarmalanmamış olması gerekir.

System.Runtime.InteropServices.ComVisibleAttribute Değerine sahip bir öznitelik, bu türün true bir örneğini oluşturmak için bu yöntemin COM türüne açıkça veya varsayılan olarak uygulanmalıdır; aksi takdirde oluşturulurTypeLoadException.

Ayrıca bkz.

CreateComInstanceFrom(String, String)

Şunlara uygulanır

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