AppDomain.CreateComInstanceFrom Метод

Определение

Создает новый экземпляр указанного типа COM.

Перегрузки

Имя Описание
CreateComInstanceFrom(String, String)

Создает новый экземпляр указанного типа COM. Параметры указывают имя файла, содержащего сборку, содержащую тип и имя типа.

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

Создает новый экземпляр указанного типа COM. Параметры указывают имя файла, содержащего сборку, содержащую тип и имя типа.

CreateComInstanceFrom(String, String)

Создает новый экземпляр указанного типа COM. Параметры указывают имя файла, содержащего сборку, содержащую тип и имя типа.

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

Параметры

assemblyName
String

Имя файла, содержащего сборку, которая определяет запрошенный тип.

typeName
String

Имя запрошенного типа.

Возвращаемое значение

Объект, представляющий собой оболочку для нового экземпляра, указанного в typeName. Возвращаемое значение должно быть раскрыто для доступа к реальному объекту.

Исключения

assemblyName или typeName есть null.

Тип не может быть загружен.

Операция выполняется в выгруженном домене приложения.

Не найден открытый конструктор без параметров.

assemblyName не найден.

typeName является абстрактным классом.

–или–

Этот элемент был вызван с помощью механизма последней привязки.

Вызывающий объект не может предоставлять атрибуты активации для объекта, от который не наследуется MarshalByRefObject.

assemblyName — пустая строка ("").

assemblyName не является допустимой сборкой.

Сборка или модуль была загружена дважды с двумя разными доказательствами.

Объект COM, на который ссылается ссылка null.

Примеры

В следующем примере показано

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

Комментарии

Используйте этот метод для удаленного создания объектов без необходимости локальной загрузки типа.

Возвращаемое значение должно быть разорвано для доступа к реальному объекту.

Атрибут System.Runtime.InteropServices.ComVisibleAttribute со значением true должен применяться явным образом или по умолчанию к типу COM для этого метода для создания экземпляра этого типа; в противном случае TypeLoadException создается исключение.

См. также раздел

Применяется к

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

Создает новый экземпляр указанного типа COM. Параметры указывают имя файла, содержащего сборку, содержащую тип и имя типа.

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

Параметры

assemblyFile
String

Имя файла, содержащего сборку, которая определяет запрошенный тип.

typeName
String

Имя запрошенного типа.

hashValue
Byte[]

Представляет значение вычисляемого хэш-кода.

hashAlgorithm
AssemblyHashAlgorithm

Представляет хэш-алгоритм, используемый манифестом сборки.

Возвращаемое значение

Объект, представляющий собой оболочку для нового экземпляра, указанного в typeName. Возвращаемое значение должно быть раскрыто для доступа к реальному объекту.

Исключения

assemblyFile или typeName есть null.

Тип не может быть загружен.

Операция выполняется в выгруженном домене приложения.

Не найден открытый конструктор без параметров.

assemblyFile не найден.

typeName является абстрактным классом.

–или–

Этот элемент был вызван с помощью механизма последней привязки.

Вызывающий объект не может предоставлять атрибуты активации для объекта, от который не наследуется MarshalByRefObject.

assemblyFile — пустая строка ("").

assemblyFile не является допустимой сборкой.

Сборка или модуль была загружена дважды с двумя разными доказательствами.

Объект COM, на который ссылается ссылка null.

Комментарии

Используйте этот метод для удаленного создания объектов без необходимости локальной загрузки типа.

Возвращаемое значение должно быть разорвано для доступа к реальному объекту.

Атрибут System.Runtime.InteropServices.ComVisibleAttribute со значением true должен применяться явным образом или по умолчанию к типу COM для этого метода для создания экземпляра этого типа; в противном случае TypeLoadException создается исключение.

См. также раздел

Применяется к