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 seguinte demonstra como aplicar ComRegisterFunctionAttribute e ComUnregisterFunctionAttribute a 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

Observações

Pode aplicar esta característica a métodos.

ComRegisterFunctionAttribute permite adicionar códigos de registo arbitrários para acomodar os requisitos dos clientes COM. Por exemplo, pode atualizar o registo usando funções de registo a partir do espaço de nomes Microsoft.Win32. Se fornecer um método de registo, deve também candidatar-se System.Runtime.InteropServices.ComUnregisterFunctionAttribute a um método de desregisto, que reverte as operações realizadas no método de registo.

.NET Framework: O runtime da linguagem comum chama o método com este atributo quando o assembly que o contém está registado (direta ou indiretamente) com a ferramenta Regasm.exe (Assembly Registration)) ou através do método RegistrationServices.RegisterAssembly.

.NET Core: O runtime da linguagem comum chama o método com este atributo quando o host COM do assembly que o contém é registado através da ferramenta RegSvr32.exe.

Este atributo pode ser aplicado apenas a métodos que possuem as seguintes características:

• Âmbito: Qualquer um (público, privado, e assim por diante).

• Tipo: static.

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

• Tipo de devolução: void.

Ver também

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