ComRegisterFunctionAttribute Clase

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Especifica el método al que se debe llamar cuando se registre un ensamblado para utilizarlo desde COM; de esta manera, se permite la ejecución de código escrito por el usuario durante el proceso de registro.

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

Herencia

Object

Attribute

ComRegisterFunctionAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar ComRegisterFunctionAttribute y ComUnregisterFunctionAttribute a métodos con la firma adecuada.

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

Comentarios

Puede aplicar este atributo a métodos.

ComRegisterFunctionAttribute permite agregar código de registro arbitrario para adaptarse a los requisitos de los clientes COM. Por ejemplo, puede actualizar el registro mediante funciones de registro del Microsoft.Win32 espacio de nombres . Si proporciona un método de registro, también debe aplicar System.Runtime.InteropServices.ComUnregisterFunctionAttribute a un método de anulación del registro, lo que invierte las operaciones realizadas en el método de registro.

.NET Framework: Common Language Runtime llama al método con este atributo cuando su ensamblado contenedor se registra (directa o indirectamente) con la herramientaRegasm.exe (Registro de ensamblados) o a través del RegistrationServices.RegisterAssembly método .

.NET Core: Common Language Runtime llama al método con este atributo cuando el host COM del ensamblado contenedor se registra a través de la herramientaRegSvr32.exe.

Este atributo solo se puede aplicar a los métodos que tienen las siguientes características:

• Ámbito: cualquiera (público, privado, etc.).

• Escriba: static.

• Parámetros: acepta un único Type parámetro o un String tipo de parámetro.

• Tipo de valor devuelto: void.

Constructores

ComRegisterFunctionAttribute()

Inicializa una nueva instancia de la clase ComRegisterFunctionAttribute.

Propiedades

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Devuelve un valor que indica si esta instancia es igual que un objeto especificado. (Heredado de Attribute)
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de Attribute)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• ComUnregisterFunctionAttribute
• RegisterAssembly(Assembly, AssemblyRegistrationFlags)
• Regasm.exe (Herramienta de registro de ensamblados)