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 создается исключение.