ComRegisterFunctionAttribute Classe

Definição

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

Herança

Object

Attribute

ComRegisterFunctionAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Exemplos

O exemplo a seguir demonstra como aplicar ComRegisterFunctionAttribute e ComUnregisterFunctionAttribute aos métodos com a assinatura apropriada.

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

Comentários

Você pode aplicar esse atributo a métodos.

ComRegisterFunctionAttribute permite adicionar código de registro arbitrário para acomodar os requisitos dos clientes COM. Por exemplo, você pode atualizar o registro usando funções de registro do namespace Microsoft.Win32. Se você fornecer um método de registro, também deverá aplicar System.Runtime.InteropServices.ComUnregisterFunctionAttribute a um método de cancelamento de registro, o que inverte as operações feitas no método de registro.

.NET Framework: O common language runtime chama o método com esse atributo quando seu assembly independente é registrado (direta ou indiretamente) com a ferramenta Regasm.exe (Registro de Assembly) ou por meio do método RegistrationServices.RegisterAssembly.

.NET Core: O common language runtime chama o método com esse atributo quando o host COM do assembly está registrado por meio da ferramenta RegSvr32.exe.

Esse atributo só pode ser aplicado a métodos que têm as seguintes características:

• Escopo: Qualquer (público, privado e assim por diante).

• Tipo: static.

• Parâmetros: aceita um único Type parâmetro ou um tipo de String parâmetro.

• Tipo de retorno: void.

Confira também

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (Ferramenta de Registro de Assembly)