DefaultEventAttribute-Klasse

Gibt das Standardereignis für eine Komponente an.

Namespace: System.ComponentModel
Assembly: System (in system.dll)

Syntax

'Declaration
<AttributeUsageAttribute(AttributeTargets.Class)> _
Public NotInheritable Class DefaultEventAttribute
    Inherits Attribute
'Usage
Dim instance As DefaultEventAttribute

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class DefaultEventAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class)] 
public ref class DefaultEventAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class DefaultEventAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Class) 
public final class DefaultEventAttribute extends Attribute

Hinweise

Verwenden Sie die Name-Eigenschaft, wenn Sie den Namen des Standardereignisses abrufen möchten.

Weitere Informationen finden Sie unter Übersicht über Attribute und Erweitern von Metadaten mithilfe von Attributen.

Beispiel

Im folgenden Beispiel wird die Auflistungsklasse MyCollection definiert. Die Klasse wird mit DefaultEventAttribute markiert und CollectionChanged so als Standardereignis festgelegt.

<DefaultEvent("CollectionChanged")> _ 
Public Class MyCollection
    Inherits BaseCollection

    Public Event CollectionChanged (ByVal sender As Object, _
        ByVal e As CollectionChangeEventArgs)
    
    ' Insert additional code.
End Class 'MyCollection

[DefaultEvent("CollectionChanged")]
public class MyCollection : BaseCollection {
     
    private CollectionChangeEventHandler onCollectionChanged;
     
    public event CollectionChangeEventHandler CollectionChanged {
       add {
          onCollectionChanged += value;
       }
       remove {
          onCollectionChanged -= value;
       }
    }
    // Insert additional code.
}

[DefaultEvent("CollectionChanged")]
public ref class TestCollection: public BaseCollection
{
private:
    CollectionChangeEventHandler^ onCollectionChanged;
    
public:
    event CollectionChangeEventHandler^ CollectionChanged 
    {
    public:
        void add(CollectionChangeEventHandler^ eventHandler)
        { 
            onCollectionChanged += eventHandler; 
        }

    protected:
        void remove(CollectionChangeEventHandler^ eventHandler) 
        { 
            onCollectionChanged -= eventHandler; 
        }
    }
    // Insert additional code.
};

/** @attribute DefaultEvent("CollectionChanged")
 */
public static class MyCollection extends BaseCollection
{
    private CollectionChangeEventHandler onCollectionChanged;

    public void add_onCollectionChanged(CollectionChangeEventHandler value)
    {
        onCollectionChanged = (CollectionChangeEventHandler)
            System.Delegate.Combine(onCollectionChanged, value);
    }

    public void remove_onCollectionChanged(CollectionChangeEventHandler
        value)
    {
        onCollectionChanged = (CollectionChangeEventHandler)
            System.Delegate.Remove(onCollectionChanged, value);
    }
    // Insert additional code.
} //MyCollection

Im folgenden Beispiel wird eine Instanz von MyCollection erstellt. Anschließend werden die Attribute für die Klasse abgerufen, DefaultEventAttribute extrahiert und der Name des Standardereignisses ausgegeben.

Public Shared Function Main() As Integer
    ' Creates a new collection.
    Dim myNewCollection As New MyCollection()
    
    ' Gets the attributes for the collection.
    Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(myNewCollection)
    
    ' Prints the name of the default event by retrieving the
    ' DefaultEventAttribute from the AttributeCollection. 
    Dim myAttribute As DefaultEventAttribute = _
        CType(attributes(GetType(DefaultEventAttribute)), DefaultEventAttribute)
    Console.WriteLine(("The default event is: " & myAttribute.Name))
    Return 0
End Function 'Main

public static int Main() {
    // Creates a new collection.
    MyCollection myNewCollection = new MyCollection();
 
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.GetAttributes(myNewCollection);
 
    /* Prints the name of the default event by retrieving the 
     * DefaultEventAttribute from the AttributeCollection. */
    DefaultEventAttribute myAttribute = 
       (DefaultEventAttribute)attributes[typeof(DefaultEventAttribute)];
    Console.WriteLine("The default event is: " + myAttribute.Name);
    return 0;
 }

int main()
{
    // Creates a new collection.
    DefaultEventAttributeExample::TestCollection^ newCollection = 
        gcnew DefaultEventAttributeExample::TestCollection;
    
    // Gets the attributes for the collection.
    AttributeCollection^ attributes = 
        TypeDescriptor::GetAttributes(newCollection);
    
    // Prints the name of the default event by retrieving the 
    // DefaultEventAttribute from the AttributeCollection.
    DefaultEventAttribute^ attribute = (DefaultEventAttribute^)
        attributes[DefaultEventAttribute::typeid];
    Console::WriteLine("The default event is: {0}", attribute->Name);
}

public static void main(String[] args)
{
    // Creates a new collection.
    MyCollection myNewCollection = new MyCollection();
    // Gets the attributes for the collection.
    AttributeCollection attributes = TypeDescriptor.
        GetAttributes(myNewCollection);

    /* Prints the name of the default event by retrieving the 
     * DefaultEventAttribute from the AttributeCollection. */
    DefaultEventAttribute myAttribute = (DefaultEventAttribute)attributes.
        get_Item(DefaultEventAttribute.class.ToType());
    Console.WriteLine("The default event is: " + myAttribute.get_Name());
} //main

Vererbungshierarchie

System.Object
   System.Attribute
    System.ComponentModel.DefaultEventAttribute

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 Millennium Edition, 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

Siehe auch

Referenz

DefaultEventAttribute-Member
System.ComponentModel-Namespace
Attribute