AppDomain.CreateComInstanceFrom Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy nowe wystąpienie określonego typu COM.
Przeciążenia
CreateComInstanceFrom(String, String) |
Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu. |
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm) |
Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu. |
CreateComInstanceFrom(String, String)
Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu.
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
Parametry
- assemblyName
- String
Nazwa pliku zawierającego zestaw, który definiuje żądany typ.
- typeName
- String
Nazwa żądanego typu.
Zwraca
Obiekt, który jest otoką dla nowego wystąpienia określonego przez typeName
. Zwracana wartość musi być bez otoki, aby miała dostęp do rzeczywistego obiektu.
Wyjątki
assemblyName
lub typeName
to null
.
Nie można załadować typu.
Próba wykonania operacji w niezaładowanej domenie aplikacji.
Nie znaleziono publicznego konstruktora bez parametrów.
assemblyName
nie można odnaleźć.
typeName
jest klasą abstrakcyjną.
-lub-
Ten element członkowski został wywołany z użyciem mechanizmu opóźnionego wiązania.
Obiekt wywołujący nie może podać atrybutów aktywacji dla obiektu, który nie dziedziczy z MarshalByRefObjectklasy .
assemblyName
jest pustym ciągiem ("").
assemblyName
nie jest prawidłowym zestawem.
Zestaw lub moduł został załadowany dwukrotnie z dwoma różnymi dowodami.
Obiekt COM, do którego jest odwoływany, to null
.
Przykłady
W poniższym przykładzie pokazano
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
Uwagi
Ta metoda umożliwia zdalne tworzenie obiektów bez konieczności lokalnego ładowania typu.
Wartość zwracana musi zostać rozpasana, aby uzyskać dostęp do rzeczywistego obiektu.
Atrybut System.Runtime.InteropServices.ComVisibleAttribute o wartości true
musi być stosowany jawnie lub domyślnie do typu COM dla tej metody w celu utworzenia wystąpienia tego typu; w przeciwnym razie TypeLoadException jest zgłaszany.
Zobacz też
Dotyczy
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)
Tworzy nowe wystąpienie określonego typu COM. Parametry określają nazwę pliku zawierającego zestaw zawierający typ i nazwę typu.
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
Parametry
- assemblyFile
- String
Nazwa pliku zawierającego zestaw definiujący żądany typ.
- typeName
- String
Nazwa żądanego typu.
- hashValue
- Byte[]
Reprezentuje wartość obliczonego kodu skrótu.
- hashAlgorithm
- AssemblyHashAlgorithm
Reprezentuje algorytm skrótu używany przez manifest zestawu.
Zwraca
Obiekt, który jest otoką dla nowego wystąpienia określonego przez typeName
. Zwracana wartość musi być bez otoki, aby miała dostęp do rzeczywistego obiektu.
Wyjątki
assemblyName
lub typeName
to null
.
Nie można załadować typu.
Próba wykonania operacji w niezaładowanej domenie aplikacji.
Nie znaleziono publicznego konstruktora bez parametrów.
assemblyFile
nie można odnaleźć.
typeName
jest klasą abstrakcyjną.
-lub-
Ten element członkowski został wywołany z użyciem mechanizmu opóźnionego wiązania.
Obiekt wywołujący nie może podać atrybutów aktywacji dla obiektu, który nie dziedziczy z MarshalByRefObjectklasy .
assemblyFile
jest pustym ciągiem ("").
assemblyFile
nie jest prawidłowym zestawem.
Zestaw lub moduł został załadowany dwukrotnie z dwoma różnymi dowodami.
Obiekt COM, do którego jest odwoływany, to null
.
Uwagi
Ta metoda umożliwia zdalne tworzenie obiektów bez konieczności lokalnego ładowania typu.
Wartość zwracana musi zostać rozpasana, aby uzyskać dostęp do rzeczywistego obiektu.
Atrybut System.Runtime.InteropServices.ComVisibleAttribute o wartości true
musi być stosowany jawnie lub domyślnie do typu COM dla tej metody w celu utworzenia wystąpienia tego typu; w przeciwnym razie TypeLoadException jest zgłaszany.