Contrôle de l'utilisateur - Propriétés personnalisées

Question

J'ai développé un contrôle utilisateur dans Visual Studio (WinForms C#) et j'ai une question.

J'ai besoin que l'utilisateur de mon contrôle d'utilisateur puisse modifier certaines valeurs de chaîne et j'aimerais qu'il puisse ajouter le contrôle d'utilisateur à son formulaire et cliquer dessus pour faire apparaître le volet des propriétés où les propriétés personnalisées de mon contrôle d'utilisateur seront affichées.

Comment puis-je avoir mes propres propriétés personnalisées pour mon contrôle d'utilisateur ? Par exemple :

Mon contrôle utilisateur contient un TextBox, et je voudrais que l'utilisateur puisse modifier la valeur de ce TextBox via une propriété nommée "Text" ou "Value" dans les propriétés au moment de la conception.

Answer 1

Vous faites cela via les attributs des propriétés, comme ceci :

[Description("Test text displayed in the textbox"),Category("Data")] 
public string Text {
  get => myInnerTextBox.Text;
  set => myInnerTextBox.Text = value;
}

La catégorie est le titre sous lequel la propriété apparaîtra dans la boîte de propriétés de Visual Studio. Voici une référence MSDN plus complète y compris une liste de catégories.

Answer 2

C'est très simple, il suffit d'ajouter une propriété :

public string Value {
  get { return textBox1.Text; }
  set { textBox1.Text = value; }
}

L'utilisation de la propriété Text est un peu plus délicate, la classe UserControl cache intentionnellement il. Vous devrez remplacer les attributs pour le remettre en état de marche :

[Browsable(true), EditorBrowsable(EditorBrowsableState.Always), Bindable(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
public override string Text {
  get { return textBox1.Text; }
  set { textBox1.Text = value; }
}

Answer 3

Il suffit d'ajouter des propriétés publiques au contrôle de l'utilisateur.

Vous pouvez ajouter [Category("MyCategory")] y [Description("A property that controls the wossname")] pour le rendre plus agréable, mais tant que c'est une público il devrait apparaître dans le panneau de propriétés.