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 adı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 adı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 adı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

typeNametarafından belirtilen yeni örnek için sarmalayıcı olan nesne. Gerçek nesneye erişmek için dönüş değerinin eşlenmemiş olması gerekir.

Özel durumlar

ArgumentNullException

assemblyName veya typeNamenull.

TypeLoadException

Tür yüklenemiyor.

AppDomainUnloadedException

İşlem, kaldırılmış bir uygulama etki alanında denendi.

MissingMethodException

Genel parametresiz oluşturucu bulunamadı.

FileNotFoundException

assemblyName bulunamadı.

MemberAccessException

typeName soyut bir sınıftır.

-veya-

Bu üye geç bağlama mekanizmasıyla çağrıldı.

NotSupportedException

Çağıran, MarshalByRefObject'den devralmayan bir nesne için etkinleştirme öznitelikleri sağlayamaz.

ArgumentException

assemblyName boş bir dizedir ("").

BadImageFormatException

assemblyName geçerli bir derleme değil.

FileLoadException

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

NullReferenceException

Başvurulmakta olan COM nesnesi 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 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

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 eşlenmemiş olması gerekir.

true değerine sahip bir System.Runtime.InteropServices.ComVisibleAttribute özniteliği, bu yöntemin bu tür bir örneğini oluşturmak için com türüne açıkça veya varsayılan olarak uygulanmalıdır; aksi takdirde, TypeLoadException oluşturulur.

Ayrıca bkz.

CreateComInstanceFrom(String, String)

Şunlara uygulanır

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

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

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