Exemplarische Vorgehensweise: Hinzufügen eines einfachen Attributs zu einem Benutzersteuerelement
Aktualisiert: November 2007
Diese exemplarische Vorgehensweise veranschaulicht das Hinzufügen eines Attributs zu einem Benutzersteuerelement in einem Geräteprojekt. Genauer gesagt, fügen Sie ein benutzerdefiniertes Attribut hinzu, das eine Eigenschaft des Steuerelements zur Entwurfszeit unsichtbar macht. Sie können dieses Feature einem Projekt hinzufügen, um zu verhindern, dass ein Eigenschaftenwert geändert wird.
Dieser Prozess ist mit dem Prozess für den Desktop vergleichbar. Eine Ausnahme besteht jedoch darin, dass Geräteprojekte diese Informationen in einer separaten Metadatendatei (.xmta) speichern.
.gif "Hinweis") Hinweis: |
|---|
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen. |
Diese exemplarische Vorgehensweise wurde mithilfe von Visual C#-Entwicklungseinstellungen geschrieben.
So erstellen Sie die UserControl1-Klasse
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Erweitern Sie im Bereich Projekttypen den Eintrag Visual C#, und klicken Sie dann auf Intelligentes Gerät.
Klicken Sie im Bereich Vorlagen auf Projekt für intelligente Geräte.
Geben Sie MyControlLibrary in das Feld Name ein, und klicken Sie dann auf OK.
Wählen Sie im Dialogfeld Neues Projekt für intelligente Geräte hinzufügen im Dropdownmenü Zielplattform die Option Pocket PC 2003 aus, wählen Sie im Dropdownmenü .NET Compact Framework die Option .NET Compact Framework Version 2.0 aus, klicken Sie im Bereich Vorlagen auf Steuerelementbibliothek und dann auf OK.
Der Designer wird in einem Quadrat mit der neuen Benutzersteuerelementklasse geöffnet.
So fügen Sie eine Eigenschaft hinzu
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf UserControl1.cs, und klicken Sie dann auf Klassendiagramm anzeigen.
Ein abgerundetes Rechteck mit dem Klassendiagramm wird geöffnet.
Klicken Sie mit der rechten Maustaste auf das Klassendiagramm, und klicken Sie dann auf Klassendetails.
Geben Sie im Bereich Eigenschaften des Fensters Klassendetails an der Eingabeaufforderung <Eigenschaft hinzufügen> den Namen MyProperty ein.
Ersetzen Sie int in der Spalte Typ durch string.
Klicken Sie mit der rechten Maustaste auf das Symbol am Anfang der Zeile MyProperty, und klicken Sie dann auf Eigenschaften.
Um einen Wert für die Custom Attributes-Eigenschaft anzugeben, klicken Sie auf die Schaltfläche mit dem Auslassungszeichen (...), um das Dialogfeld Benutzerdefinierte Attribute zu öffnen.
Geben Sie Browsable(false) ein, und klicken Sie dann auf OK.
Im Projektmappen-Explorer wird eine XMTA-Datei mit einem Entwurfszeitattribut (DesignTimeAttributes.xmta) angezeigt, die das benutzerdefinierte Attribut enthält.
So erstellen Sie die Steuerelementbibliothek
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf UserControl1.cs und dann auf Code anzeigen.
Kommentieren Sie die Zeile aus, die die System.NotImplementedException auslöst, und fügen Sie stattdessen return ""; als get-Aktion ein.
Klicken Sie im Menü Erstellen auf MyControlLibrary erstellen.
So testen Sie, das MyProperty nicht im Eigenschaftenbrowser angezeigt wird
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf MyControlLibrary, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.
Klicken Sie im Dialogfeld Neues Element hinzufügen im Bereich Kategorien auf Windows Forms und im Bereich Vorlagen auf Windows Form und dann auf Hinzufügen.
Ziehen Sie UserControl1 aus der Toolbox auf das Formular.
Klicken Sie mit der rechten Maustaste auf das Bild des Benutzersteuerelements im Formular, und klicken Sie dann auf Eigenschaften.
MyProperty wird nicht im Eigenschaftenbrowser angezeigt.
Doppelklicken Sie im Projektmappen-Explorer auf die XMTA-Datei, und ersetzen Sie dann false durch true.
Wiederholen Sie die Schritte, um das Eigenschaftenraster anzuzeigen. Beachten Sie, dass nun MyProperty angezeigt wird.
Siehe auch
Referenz
Visual Basic und Visual C# (Vorgehensweise für intelligente Geräte)