InterfaceTypeAttribute Osztály

Definíció

Névtér:

System.Runtime.InteropServices

Szerelvények:

netstandard.dll, System.Runtime.InteropServices.dll

Forrás:

InterfaceTypeAttribute.cs

Azt jelzi, hogy a felügyelt felület kettős, csak kézbesítési vagy IUnknown -only-e, ha a COM-nak van kitéve.

public ref class InterfaceTypeAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
public sealed class InterfaceTypeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
type InterfaceTypeAttribute = class
    inherit Attribute

Public NotInheritable Class InterfaceTypeAttribute
Inherits Attribute

Öröklődés

Object

Attribute

InterfaceTypeAttribute

Attribútumok

AttributeUsageAttribute

Példák

Az alábbi példa bemutatja, hogyan InterfaceTypeAttribute vezérli az interfész a COM-nak való kitettségét.

using namespace System::Runtime::InteropServices;

//Interface is exposed to COM as dual.
interface class IMyInterface1{};

//Insert code here.
//Interface is exposed to COM as IDispatch.

[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIDispatch)]
interface class IMyInterface2{};
//Insert code here.

using System.Runtime.InteropServices;

//Interface is exposed to COM as dual.
interface IMyInterface1
{
    //Insert code here.
}

//Interface is exposed to COM as IDispatch.
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIDispatch)]
interface IMyInterface2
{
    //Insert code here.
}

Imports System.Runtime.InteropServices

'Interface is exposed to COM as dual.
Interface IMyInterface1
     'Insert code here.
End Interface

'Interface is exposed to COM as IDispatch.
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIDispatch)> _
Interface IMyInterface2
    'Insert code here.
End Interface

Megjegyzések

Ezt az attribútumot alkalmazhatja a felületekre.

Alapértelmezés szerint a Tlbexp.exe (Típustár-exportőr) egy felügyelt felületet tesz elérhetővé a COM-nak kettős interfészként, így rugalmasan megkötheti a késői kötést vagy a korai kötés teljesítményét. Az ComInterfaceType enumerálással felülbírálhatja az alapértelmezett viselkedést, és csak késői kötést vagy csak korai kötést adhat meg. Alkalmazhatja például egy felületre a InterfaceType (ComInterfaceType.InterfaceIsIDispatch) metaadatok előállításához, hogy a hívók csak késői kötésre korlátozódjanak. Bár az IDispatch interfészből származó felületek gyakran kettősek, az InterfaceIsIDispatch enumerálási tag csak késői hívásokat engedélyez a felületi metódusokhoz. Ez az attribútum nincs hatással a felület felügyelt nézetére. További információ arról, hogy a felületek hogyan érhetők el a COM-nak, lásd: Exportált típuskonvertálás.

A Tlbimp.exe (Típustár-importáló) ezt az attribútumot az importált, nem nyelvi felületekre is alkalmazza; a megfelelő enumerálási tagot alkalmazza annak jelzésére, hogy a felület csak küldési vagy IUnknown -only.

Konstruktorok

Name	Description
InterfaceTypeAttribute(ComInterfaceType)	Inicializálja az osztály új példányát InterfaceTypeAttribute a megadott ComInterfaceType enumerálási taggal.
InterfaceTypeAttribute(Int16)	Inicializálja az osztály új példányát InterfaceTypeAttribute a megadott ComInterfaceType enumerálási taggal.

Tulajdonságok

Name	Description
TypeId	Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap. (Öröklődés forrása Attribute)
Value	Lekéri azt az ComInterfaceType értéket, amely leírja, hogy a felület hogyan legyen közzétéve a COM-nak.

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e egy adott objektummal. (Öröklődés forrása Attribute)
GetHashCode()	A példány kivonatkódját adja vissza. (Öröklődés forrása Attribute)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsDefaultAttribute()	Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke. (Öröklődés forrása Attribute)
Match(Object)	Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e. (Öröklődés forrása Attribute)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• ComInterfaceType
• Tlbexp.exe (típuskódtár-exportőr)
• Tlbimp.exe (típustár-importáló)