ComRegisterFunctionAttribute Класс

Определение

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)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComRegisterFunctionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ComRegisterFunctionAttribute = class
    inherit 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

Примеры

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

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: Общеязыковая среда выполнения вызывает метод с этим атрибутом, когда его содержащая сборка зарегистрирована (прямо или косвенно) с помощью средстваRegasm.exe (регистрация сборки) или с помощью RegistrationServices.RegisterAssembly метода .

.NET Core: Среда CLR вызывает метод с этим атрибутом, когда его узел COM, содержащий сборку, зарегистрирован через средствоRegSvr32.exe.

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

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

• Введите static.

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

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

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

Свойства

Методы

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

Применяется к

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

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