ComRegisterFunctionAttribute Класс

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

mscorlib.dll

Задает метод для вызова при регистрации сборки для использования из COM; это позволяет выполнять написанный пользователем код во время регистрации.

public ref class ComRegisterFunctionAttribute sealed : Attribute

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

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

Public NotInheritable Class ComRegisterFunctionAttribute
Inherits Attribute

Наследование

Object

Attribute

ComRegisterFunctionAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Примеры

В следующем примере показано, как применять и ComUnregisterFunctionAttribute применять ComRegisterFunctionAttribute методы с соответствующей сигнатурой.

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

Комментарии

Этот атрибут можно применить к методам.

ComRegisterFunctionAttribute позволяет добавить произвольный код регистрации для удовлетворения требований клиентов COM. Например, можно обновить реестр с помощью функций регистрации из пространства имен Microsoft.Win32. Если вы предоставляете метод регистрации, то также следует применить System.Runtime.InteropServices.ComUnregisterFunctionAttribute к методу отмены регистрации, который отменяет операции, выполненные в методе регистрации.

.NET Framework: Среда CLR вызывает метод с этим атрибутом, если его содержащая сборка зарегистрирована (прямо или косвенно) с помощью средства Regasm.exe (регистрация сборок) или через метод RegistrationServices.RegisterAssembly.

.NET Core: Среда CLR вызывает метод с этим атрибутом при регистрации com-узла сборки через средство RegSvr32.exe.

Этот атрибут можно применять только к методам, имеющим следующие характеристики:

• Область: Любая (общедоступная, частная и т. д.).

• Тип: static.

• Параметры: принимает один Type параметр или String тип параметра.

• Тип возвращаемого значения: void.

Конструкторы

Имя	Описание
ComRegisterFunctionAttribute()	Инициализирует новый экземпляр класса ComRegisterFunctionAttribute.

Свойства

Имя	Описание
TypeId	При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute)

Методы

Имя	Описание
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код для этого экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Извлекает сведения о типе объекта, который можно использовать для получения сведений о типе для интерфейса. (Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Предоставляет доступ к свойствам и методам, предоставляемым объектом. (Унаследовано от Attribute)

См. также раздел

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (средство регистрации сборок)