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 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
Комментарии
Используйте этот метод для удаленного создания объектов без локальной загрузки типа.
Возвращаемое значение должно быть распаковано для доступа к реальному объекту.
Атрибут 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
. Необходимо распаковать возвращенное значение, чтобы получить доступ к реальному объекту.
Исключения
Параметр assemblyName
или typeName
имеет значение null
.
Не удалось загрузить тип.
Предпринята попытка выполнения операции с выгруженным доменом приложения.
Открытый конструктор без параметров не найден.
assemblyFile
не найден.
Класс typeName
представляет собой абстрактный класс.
-или-
Этот элемент был вызван при помощи механизма позднего связывания.
Вызывающий объект не может предоставить атрибуты активации для объекта, который не является производным от MarshalByRefObject.
assemblyFile
является пустой строкой ("").
assemblyFile
не является допустимой сборкой.
Сборка или модуль был загружен дважды с двумя разными свидетельствами.
Указанный объект COM равен null
.
Комментарии
Используйте этот метод для удаленного создания объектов без локальной загрузки типа.
Возвращаемое значение должно быть распаковано для доступа к реальному объекту.
Атрибут System.Runtime.InteropServices.ComVisibleAttribute со значением true
должен применяться явным образом или по умолчанию к типу COM для этого метода, чтобы создать экземпляр этого типа; в противном случае TypeLoadException создается исключение.