AppDomain.CreateComInstanceFrom Metode

Referensi

Definisi

Ruang nama:: System

Rakitan:: mscorlib.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Membuat instans baru dari jenis COM tertentu.

Overload

CreateComInstanceFrom(String, String)	Membuat instans baru dari jenis COM tertentu. Parameter menentukan nama file yang berisi rakitan yang berisi jenis dan nama jenis.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Membuat instans baru dari jenis COM tertentu. Parameter menentukan nama file yang berisi rakitan yang berisi jenis dan nama jenis.

CreateComInstanceFrom(String, String)

Membuat instans baru dari jenis COM tertentu. Parameter menentukan nama file yang berisi rakitan yang berisi jenis dan nama jenis.

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

Parameter

assemblyName: String

Nama file yang berisi rakitan yang menentukan jenis yang diminta.

typeName: String

Nama jenis yang diminta.

Mengembalikan

ObjectHandle

Objek yang merupakan pembungkus untuk instans baru yang ditentukan oleh typeName. Nilai yang dikembalikan perlu dibongkar untuk mengakses objek nyata.

Pengecualian

ArgumentNullException

assemblyName atau typeNamenull.

TypeLoadException

Tipe tidak dapat dimuat.

AppDomainUnloadedException

Operasi ini dicoba pada domain aplikasi yang tidak dimuat.

MissingMethodException

Tidak ada konstruktor tanpa parameter publik yang ditemukan.

FileNotFoundException

assemblyName tidak ditemukan.

MemberAccessException

typeName adalah kelas abstrak.

-atau-

Anggota ini dipanggil dengan mekanisme pengikatan terlambat.

NotSupportedException

Pemanggil tidak dapat menyediakan atribut aktivasi untuk objek yang tidak mewarisi dari MarshalByRefObject.

ArgumentException

assemblyName adalah string kosong ("").

BadImageFormatException

assemblyName bukan rakitan yang valid.

FileLoadException

Rakitan atau modul dimuat dua kali dengan dua bukti yang berbeda.

NullReferenceException

Objek COM yang sedang dirujuk adalah null.

Contoh

Sampel berikut menunjukkan

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

Keterangan

Gunakan metode ini untuk membuat objek dari jarak jauh tanpa harus memuat jenis secara lokal.

Nilai yang dikembalikan harus dibongkar untuk mengakses objek nyata.

Atribut System.Runtime.InteropServices.ComVisibleAttribute dengan nilai true harus diterapkan secara eksplisit atau secara default ke jenis COM agar metode ini dapat membuat instans jenis tersebut; jika tidak, TypeLoadException dilemparkan.

Lihat juga

CreateComInstanceFrom(String, String)

Berlaku untuk

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