Clase ComUnregisterFunctionAttribute
Publicado: octubre de 2016
Especifica el método al que llamar cuando se anula el registro de un ensamblado para utilizarlo desde COM; Esto permite la ejecución de código escrito por el usuario durante el proceso de anulación del registro.
Espacio de nombres: System.Runtime.InteropServices
Ensamblado: mscorlib (en mscorlib.dll)
Jerarquía de herencia
System.Object
System.Attribute
System.Runtime.InteropServices.ComUnregisterFunctionAttribute
Sintaxis
[AttributeUsageAttribute(AttributeTargets.Method, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class ComUnregisterFunctionAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Method, Inherited = false)]
[ComVisibleAttribute(true)]
public ref class ComUnregisterFunctionAttribute sealed : Attribute
[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Method, Inherited = false)>]
[<ComVisibleAttribute(true)>]
type ComUnregisterFunctionAttribute =
class
inherit Attribute
end
<AttributeUsageAttribute(AttributeTargets.Method, Inherited := False)>
<ComVisibleAttribute(True)>
Public NotInheritable Class ComUnregisterFunctionAttribute
Inherits Attribute
Constructores
Nombre | Descripción | |
---|---|---|
![]() |
ComUnregisterFunctionAttribute() | Inicializa una nueva instancia de la clase ComUnregisterFunctionAttribute. |
Propiedades
Nombre | Descripción | |
---|---|---|
![]() |
TypeId | Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute). |
Métodos
Nombre | Descripción | |
---|---|---|
![]() |
Equals(Object) | Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. 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). |
![]() |
ToString() | Devuelve una cadena que representa el objeto actual.(Heredado de Object). |
Implementaciones de interfaz explícitas
Nombre | Descripción | |
---|---|---|
![]() ![]() |
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) | Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute). |
![]() ![]() |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) | Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.(Heredado de Attribute). |
![]() ![]() |
_Attribute.GetTypeInfoCount(UInt32) | Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute). |
![]() ![]() |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) | Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute). |
Comentarios
Este atributo se puede aplicar a métodos.
ComUnregisterFunctionAttribute le permite agregar código que invierte las operaciones realizadas por un método de registro. Si se aplica el ComRegisterFunctionAttribute para proporcionar un método de registro, también debe proporcionar un método de anulación del registro para invertir las operaciones realizadas en el método de registro. Puede tener sólo un método de anulación del registro para una clase.
Common language runtime llama al método con este atributo cuando se anula el registro del ensamblado que lo contiene (directa o indirectamente) con el Regasm.exe (Assembly Registration Tool) o a través del RegistrationServices.UnregisterAssembly método de API. Los métodos con este atributo pueden tener cualquier visibilidad (pública, privada etc.), pero debe ser static y deben tomar un solo Type parámetro para el Type para anular el registro.
Ejemplos
En el ejemplo siguiente se muestra cómo aplicar ComRegisterFunctionAttribute y ComUnregisterFunctionAttribute a métodos con la firma apropiada.
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
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
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.
}
};
Información de versión
.NET Framework
Disponible desde 1.1
Seguridad para subprocesos
Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.
Ver también
ComRegisterFunctionAttribute
RegistrationServices.UnregisterAssembly
Espacio de nombres System.Runtime.InteropServices
Regasm.exe (Assembly Registration Tool)
Volver al principio