AppDomain.CreateComInstanceFrom Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine neue Instanz eines angegebenen COM-Typs.
Überlädt
CreateComInstanceFrom(String, String) |
Erstellt eine neue Instanz eines angegebenen COM-Typs. Parameter geben den Namen einer Datei mit einer Assembly an, die den Typ und den Typnamen enthält. |
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm) |
Erstellt eine neue Instanz eines angegebenen COM-Typs. Parameter geben den Namen einer Datei mit einer Assembly an, die den Typ und den Typnamen enthält. |
CreateComInstanceFrom(String, String)
Erstellt eine neue Instanz eines angegebenen COM-Typs. Parameter geben den Namen einer Datei mit einer Assembly an, die den Typ und den Typnamen enthält.
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
Der Name einer Datei, die eine Assembly enthält, in der der angeforderte Typ definiert ist.
- typeName
- String
Der Name des angeforderten Typs.
Gibt zurück
Ein Objekt, das ein Wrapper für die neue Instanz ist, die durch typeName
angegeben wird. Der Rückgabewert muss für den Zugriff auf das eigentliche Objekt entwrappt werden.
Ausnahmen
assemblyName
oder typeName
ist null
.
Der Typ kann nicht geladen werden.
Der Vorgang wird für eine entladene Anwendungsdomäne ausgeführt.
Es wurde kein öffentlicher parameterloser Konstruktor gefunden.
assemblyName
wurde nicht gefunden.
typeName
ist eine abstrakte Klasse.
- oder -
Dieser Member wurde durch einen Mechanismus mit später Bindung aufgerufen.
Der Aufrufer kann keine Aktivierungsattribute für ein Objekt bereitstellen, das nicht von MarshalByRefObject erbt.
assemblyName
ist eine leere Zeichenfolge ("").
assemblyName
ist keine gültige Assembly.
Eine Assembly oder ein Modul wurde zweimal mit zwei unterschiedlichen Beweisen geladen.
Das COM-Objekt, auf das verwiesen wird, ist null
.
Beispiele
Das folgende Beispiel veranschaulicht
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
Hinweise
Verwenden Sie diese Methode, um Objekte remote zu erstellen, ohne den Typ lokal zu laden.
Der Rückgabewert muss entwrappt werden, um auf das reale Objekt zuzugreifen.
Ein System.Runtime.InteropServices.ComVisibleAttribute Attribut mit einem Wert von true
muss entweder explizit oder standardmäßig auf den COM-Typ für diese Methode angewendet werden, um eine Instanz dieses Typs zu erstellen; andernfalls TypeLoadException wird ausgelöst.
Siehe auch
Gilt für
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)
Erstellt eine neue Instanz eines angegebenen COM-Typs. Parameter geben den Namen einer Datei mit einer Assembly an, die den Typ und den Typnamen enthält.
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
Parameter
- assemblyFile
- String
Der Name einer Datei, die eine Assembly enthält, in der der angeforderte Typ definiert ist.
- typeName
- String
Der Name des angeforderten Typs.
- hashValue
- Byte[]
Stellt den Wert des errechneten Hashcodes dar.
- hashAlgorithm
- AssemblyHashAlgorithm
Stellt den vom Assemblymanifest verwendeten Hashalgorithmus dar.
Gibt zurück
Ein Objekt, das ein Wrapper für die neue Instanz ist, die durch typeName
angegeben wird. Der Rückgabewert muss für den Zugriff auf das eigentliche Objekt entwrappt werden.
Ausnahmen
assemblyName
oder typeName
ist null
.
Der Typ kann nicht geladen werden.
Der Vorgang wird für eine entladene Anwendungsdomäne ausgeführt.
Es wurde kein öffentlicher parameterloser Konstruktor gefunden.
assemblyFile
wurde nicht gefunden.
typeName
ist eine abstrakte Klasse.
- oder -
Dieser Member wurde durch einen Mechanismus mit später Bindung aufgerufen.
Der Aufrufer kann keine Aktivierungsattribute für ein Objekt bereitstellen, das nicht von MarshalByRefObject erbt.
assemblyFile
ist die leere Zeichenfolge ("").
assemblyFile
ist keine gültige Assembly.
Eine Assembly oder ein Modul wurde zweimal mit zwei unterschiedlichen Beweisen geladen.
Das COM-Objekt, auf das verwiesen wird, ist null
.
Hinweise
Verwenden Sie diese Methode, um Objekte remote zu erstellen, ohne den Typ lokal zu laden.
Der Rückgabewert muss entwrappt werden, um auf das reale Objekt zuzugreifen.
Ein System.Runtime.InteropServices.ComVisibleAttribute Attribut mit einem Wert von true
muss entweder explizit oder standardmäßig auf den COM-Typ für diese Methode angewendet werden, um eine Instanz dieses Typs zu erstellen; andernfalls TypeLoadException wird ausgelöst.