DispIdAttribute-Klasse

Gibt die COM DISPID (Dispatch Identifier) einer Methode, eines Felds oder einer Eigenschaft an.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Method Or AttributeTargets.Property Or AttributeTargets.Field Or AttributeTargets.Event, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class DispIdAttribute
    Inherits Attribute
'Usage
Dim instance As DispIdAttribute

[AttributeUsageAttribute(AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Event, Inherited=false)] 
[ComVisibleAttribute(true)] 
public sealed class DispIdAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Method|AttributeTargets::Property|AttributeTargets::Field|AttributeTargets::Event, Inherited=false)] 
[ComVisibleAttribute(true)] 
public ref class DispIdAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Event, Inherited=false) */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class DispIdAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Method|AttributeTargets.Property|AttributeTargets.Field|AttributeTargets.Event, Inherited=false) 
ComVisibleAttribute(true) 
public final class DispIdAttribute extends Attribute

Hinweise

Dieses Attribut kann auf Methoden, Felder oder Eigenschaften angewendet werden.

Dieses Attribut enthält die DISPID für die beschriebene Methode, das Feld oder die Eigenschaft. Normalerweise weist die Common Language Runtime eine eindeutige DISPID zu. Mit diesem Attribut können Sie jedoch einer Methode eine bestimmte DISPID zuweisen. Beim Importieren einer Typbibliothek wird dieses Attribut auf alle Methoden mit zugewiesener DISPID angewendet. Dadurch wird sichergestellt, dass eine verwaltete Implementierung derselben Methode über die gleiche DISPID verfügt, wenn sie für COM verfügbar gemacht wird.

Beispiel

Das folgende Beispiel veranschaulicht, wie den Membern einer Klasse explizit DISPIDs zugewiesen werden können.

Imports System.Runtime.InteropServices

Class SampleClass
    
    Public Sub New()
        'Insert code here.
    End Sub
    
    <DispIdAttribute(8)> _ 
    Public Sub MyMethod()
        'Insert code here.
    End Sub    
    
    Public Function MyOtherMethod() As Integer
        'Insert code here.
        Return 0
    End Function
    
    <DispId(9)> _
    Public MyField As Boolean
End Class

using System.Runtime.InteropServices;

public class MyClass
{
   public MyClass() {}

   [DispId(8)]
   public void MyMethod() {}
   
   public int MyOtherMethod() {
      return 0;
   }
   
   [DispId(9)]
   public bool MyField;
}

using namespace System::Runtime::InteropServices;
public ref class MyClass
{
public:
   MyClass(){}


   [DispId(8)]
   void MyMethod(){}

   int MyOtherMethod()
   {
      return 0;
   }


   [DispId(9)]
   bool MyField;
};

import System.Runtime.InteropServices.*;

public class MyClass
{
    public MyClass()
    {
    } //MyClass

    /** @attribute DispId(8)
     */
    public void MyMethod()
    {
    } //MyMethod

    public int MyOtherMethod()
    {
        return 0;
    } //MyOtherMethod

    /** @attribute DispId(9)
     */
    public boolean MyField;
} //MyClass

Vererbungshierarchie

System.Object
   System.Attribute
    System.Runtime.InteropServices.DispIdAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DispIdAttribute-Member
System.Runtime.InteropServices-Namespace