Clase IDispatchImplAttribute

 

Publicado: octubre de 2016

Nota: Esta API ahora está obsoleta.

Indica qué IDispatch implementación de common language runtime utiliza cuando expone interfaces duales e interfaces dispinterface a COM.

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

Jerarquía de herencia

System.Object
  System.Attribute
    System.Runtime.InteropServices.IDispatchImplAttribute

Sintaxis

[AttributeUsageAttribute(AttributeTargets.Assembly | AttributeTargets.Class, 
    Inherited = false)]
[ObsoleteAttribute("This attribute is deprecated and will be removed in a future version.", 
    false)]
[ComVisibleAttribute(true)]
public sealed class IDispatchImplAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Assembly | AttributeTargets::Class, 
    Inherited = false)]
[ObsoleteAttribute("This attribute is deprecated and will be removed in a future version.", 
    false)]
[ComVisibleAttribute(true)]
public ref class IDispatchImplAttribute sealed : Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Assembly | AttributeTargets.Class,
    Inherited = false)>]
[<ObsoleteAttribute("This attribute is deprecated and will be removed in a future version.",
    false)>]
[<ComVisibleAttribute(true)>]
type IDispatchImplAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class,
    Inherited := False)>
<ObsoleteAttribute("This attribute is deprecated and will be removed in a future version.",
    False)>
<ComVisibleAttribute(True)>
Public NotInheritable Class IDispatchImplAttribute
    Inherits Attribute

Constructores

	Nombre	Descripción
	IDispatchImplAttribute(IDispatchImplType)	Inicializa una nueva instancia de la IDispatchImplAttribute clase con especificado IDispatchImplType valor.
	IDispatchImplAttribute(Int16)	Inicializa una nueva instancia de la IDispatchImplAttribute clase con especificado IDispatchImplType valor.

Propiedades

	Nombre	Descripción
	TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).
	Value	Obtiene el IDispatchImplType utilizado por la clase de valor.

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 clases o ensamblados.

Este atributo debe establecerse cuando se requiere una implementación explícita. Cuando se establece el atributo CompatibleImpl, el IDispatch implementación se suministra enviando la información de tipo para el objeto de COM CreateStdDispatch API. Cuando se establece el atributo InternalImpl, el IDispatch implementación proporcionada por common language runtime. Establecer el atributo en SystemDefinedImpl el Runtime podrá elegir la implementación apropiada. Al utilizar el atributo en un ensamblado, el atributo se aplica a todas las clases definidas dentro del ensamblado. Al utilizar el atributo en una clase individual, el atributo sólo se aplica a las interfaces expuestas por esa clase y reemplaza cualquier configuración de nivel de ensamblado.

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar IDispatchImplAttribute para seleccionar la IDispatch implementación proporcionada por common language runtime.

using System;
using System.Runtime.InteropServices;
// by default all classes in this assembly will use COM implementaion 
[assembly:IDispatchImpl(IDispatchImplType.CompatibleImpl)]

namespace MyNamespace
{
    // But this class will use runtime implementaion
    [IDispatchImpl(IDispatchImplType.InternalImpl)]
    class MyClass
    {
        //
    }
}

Imports System
Imports System.Runtime.InteropServices
' by default all classes in this assembly will use COM implementaion 
<Assembly: IDispatchImpl(IDispatchImplType.CompatibleImpl)> 

Module MyNamespace
    ' But this class will use runtime implementaion
    <IDispatchImpl(IDispatchImplType.InternalImpl)> _
    Public Class c
        '
    End Class

End Module

using namespace System;
using namespace System::Runtime::InteropServices;

// by default all classes in this assembly will use COM implementaion
//   // But this class will use runtime implementaion

[assembly:IDispatchImpl(IDispatchImplType::CompatibleImpl)];
[IDispatchImpl(IDispatchImplType::InternalImpl)]
ref class MyClass{};

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

IDispatchImplType
Espacio de nombres System.Runtime.InteropServices

Volver al principio