ComRegisterFunctionAttribute Klasa

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Określa metodę wywoływania podczas rejestrowania zestawu do użycia z modelu COM; Umożliwia to wykonywanie kodu napisanego przez użytkownika podczas procesu rejestracji.

public ref class ComRegisterFunctionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class ComRegisterFunctionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ComRegisterFunctionAttribute = class
    inherit Attribute

Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

ComRegisterFunctionAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak zastosować ComRegisterFunctionAttribute metody i ComUnregisterFunctionAttribute do metod z odpowiednim podpisem.

using namespace System;
using namespace System::Runtime::InteropServices;
public ref class MyClassThatNeedsToRegister
{
public:

   [ComRegisterFunctionAttribute]
   static void RegisterFunction( Type^ t )
   {
      
      //Insert code here.
   }


   [ComUnregisterFunctionAttribute]
   static void UnregisterFunction( Type^ t )
   {
      
      //Insert code here.
   }

};

using System;
using System.Runtime.InteropServices;

public class MyClassThatNeedsToRegister
{
   [ComRegisterFunctionAttribute]
   public static void RegisterFunction(Type t)
   {
      //Insert code here.
   }

   [ComUnregisterFunctionAttribute]
   public static void UnregisterFunction(Type t)
   {
      //Insert code here.
   }
}

Imports System.Runtime.InteropServices

Public Class MyClassThatNeedsToRegister
    
    <ComRegisterFunctionAttribute()> Public Shared Sub _
      RegisterFunction(t As Type)
        'Insert code here.
    End Sub
    
    <ComUnregisterFunctionAttribute()> Public Shared Sub _
      UnregisterFunction(t As Type)
        'Insert code here.
    End Sub
End Class

Uwagi

Ten atrybut można zastosować do metod.

ComRegisterFunctionAttribute Umożliwia dodanie dowolnego kodu rejestracji w celu spełnienia wymagań klientów COM. Można na przykład zaktualizować rejestr przy użyciu funkcji rejestracji z Microsoft.Win32 przestrzeni nazw. Jeśli podasz metodę rejestracji, należy również zastosować metodę System.Runtime.InteropServices.ComUnregisterFunctionAttribute wyrejestrowania, która odwraca operacje wykonywane w metodzie rejestracji.

.NET Framework: Środowisko uruchomieniowe języka wspólnego wywołuje metodę z tym atrybutem, gdy jego zawierający zestaw jest zarejestrowany (bezpośrednio lub pośrednio) za pomocą narzędziaRegasm.exe (rejestracja zestawu) lub za pomocą RegistrationServices.RegisterAssembly metody .

.NET Core: Środowisko uruchomieniowe języka wspólnego wywołuje metodę za pomocą tego atrybutu, gdy jego host COM zawierający zestaw jest zarejestrowany za pośrednictwem narzędziaRegSvr32.exe.

Ten atrybut można zastosować tylko do metod, które mają następujące cechy:

• Zakres: dowolne (publiczne, prywatne itd.).

• Typ: static.

• Parametry: akceptuje pojedynczy Type parametr lub typ parametru String .

• Zwracany typ: void.

Konstruktory

ComRegisterFunctionAttribute()

Inicjuje nowe wystąpienie klasy ComRegisterFunctionAttribute.

Właściwości

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (narzędzie rejestracji zestawów)