AppDomain.CreateComInstanceFrom Metod

Definition

Namnområde:: System

Sammansättning:: mscorlib.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en ny instans av en angiven COM-typ.

Överlagringar

Name	Description
CreateComInstanceFrom(String, String)	Skapar en ny instans av en angiven COM-typ. Parametrar anger namnet på en fil som innehåller en sammansättning som innehåller typen och namnet på typen.
CreateComInstanceFrom(String, String, Byte[], AssemblyHashAlgorithm)	Skapar en ny instans av en angiven COM-typ. Parametrar anger namnet på en fil som innehåller en sammansättning som innehåller typen och namnet på typen.

CreateComInstanceFrom(String, String)

Skapar en ny instans av en angiven COM-typ. Parametrar anger namnet på en fil som innehåller en sammansättning som innehåller typen och namnet på typen.

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

Parametrar

assemblyName: String

Namnet på en fil som innehåller en sammansättning som definierar den begärda typen.

typeName: String

Namnet på den begärda typen.

Returer

ObjectHandle

Ett objekt som är en omslutning för den nya instansen som anges av typeName. Returvärdet måste packas upp för att få åtkomst till det verkliga objektet.

Undantag

ArgumentNullException

assemblyName eller typeName är null.

TypeLoadException

Det går inte att läsa in typen.

AppDomainUnloadedException

Åtgärden görs på en oladdad programdomän.

MissingMethodException

Ingen offentlig parameterlös konstruktor hittades.

FileNotFoundException

assemblyName hittades inte.

MemberAccessException

typeName är en abstrakt klass.

-eller-

Den här medlemmen anropades med en mekanism för sen bindning.

NotSupportedException

Anroparen kan inte ange aktiveringsattribut för ett objekt som inte ärver från MarshalByRefObject.

ArgumentException

assemblyName är en tom sträng ("").

BadImageFormatException

assemblyName är inte en giltig sammansättning.

FileLoadException

En sammansättning eller modul lästes in två gånger med två olika bevis.

NullReferenceException

COM-objektet som refereras till är null.

Exempel

Följande exempel visar

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

Kommentarer

Använd den här metoden för att skapa objekt via fjärranslutning utan att behöva läsa in typen lokalt.

Returvärdet måste packas upp för att få åtkomst till det verkliga objektet.

Ett System.Runtime.InteropServices.ComVisibleAttribute attribut med värdet true måste tillämpas antingen explicit eller som standard på COM-typen för den här metoden för att skapa en instans av den typen. Annars TypeLoadException genereras.

Se även

CreateComInstanceFrom(String, String)

Gäller för

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