Partager via

PropertyGridEditorPart.Title Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtient ou définit le titre du contrôle d'édition.

public:
 virtual property System::String ^ Title { System::String ^ get(); void set(System::String ^ value); };
public override string Title { get; set; }
member this.Title : string with get, set
Public Overrides Property Title As String

Valeur de propriété

String

Chaîne utilisée comme titre du contrôle. La valeur par défaut est un nom de contrôle calculé fourni par le jeu de contrôles WebPart.

Exemples

Cet exemple de code montre comment utiliser la Title propriété d’un PropertyGridEditorPart contrôle. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la rubrique vue d’ensemble de la PropertyGridEditorPart classe.

L’exemple de code suivant montre comment définir le titre sur un PropertyGridEditorPart contrôle de manière déclarative dans une page Web.

<asp:EditorZone ID="EditorZone1" runat="server">
  <ZoneTemplate>
    <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" 
      runat="server" 
      Title="Edit Custom Properties"
      OnPreRender="PropertyGridEditorPart1_PreRender" 
      OnInit="PropertyGridEditorPart1_Init" />   
  </ZoneTemplate>
</asp:EditorZone>

<asp:EditorZone ID="EditorZone1" runat="server">
  <ZoneTemplate>
    <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" 
      runat="server" 
      Title="Edit Custom Properties"
      OnPreRender="PropertyGridEditorPart1_PreRender" 
      OnInit="PropertyGridEditorPart1_Init" />   
  </ZoneTemplate>
</asp:EditorZone>

La partie suivante de l’exemple de code montre comment définir la valeur de la Title propriété par programmation. Pour conserver la valeur affectée par programmation, une variable statique nommée editControlTitle est utilisée et cette valeur est affectée à la Title propriété chaque fois que le contrôle est initialisé, afin que la valeur soit conservée entre les événements de publication.

private static String editControlTitle;

protected void Button1_Click(object sender, EventArgs e)
{
  editControlTitle = Server.HtmlEncode(TextBox1.Text);
  PropertyGridEditorPart1.Title = editControlTitle;
}

protected void PropertyGridEditorPart1_Init(object sender, EventArgs e)
{
  if (editControlTitle != null)
    PropertyGridEditorPart1.Title = editControlTitle;
}  

Shared editControlTitle As String

Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As System.EventArgs)
  editControlTitle = Server.HtmlEncode(TextBox1.Text)
  PropertyGridEditorPart1.Title = editControlTitle 
End Sub

Protected Sub PropertyGridEditorPart1_Init(ByVal _
  sender As Object, ByVal e As System.EventArgs)
  If Not editControlTitle Is Nothing Then
    PropertyGridEditorPart1.Title = editControlTitle
  End If
End Sub

Lorsque vous chargez la page dans un navigateur, vous pouvez sélectionner Modifier le mode d’affichage dans le contrôle de liste déroulante Mode d’affichage pour basculer vers le mode d’édition. Vous pouvez cliquer sur le menu Verbes (flèche vers le bas) dans la barre de titre du contrôle WebPart Informations utilisateur , puis cliquer sur Modifier pour commencer la modification. Lorsque l’interface utilisateur de modification est visible, vous pouvez voir le PropertyGridEditorPart contrôle et une zone de texte positionnées au-dessus de celle-ci. Notez que le titre du PropertyGridEditorPart contrôle est la valeur attribuée dans le balisage déclaratif de la page Web. Si vous entrez du texte dans la zone de texte en regard du bouton Mettre à jour le titre du composant Éditeur , puis cliquez sur le bouton, le titre du contrôle est mis à jour.

Remarques

La Title valeur de propriété s’affiche dans la barre de titre d’un PropertyGridEditorPart contrôle lorsque le contrôle est visible en mode édition. Lorsque le contrôle est déclaré dans une page, vous pouvez définir une valeur pour l’attribut Title . Si vous ne fournissez pas de valeur pour le titre, une valeur par défaut spécifique à la culture est fournie.

La Title propriété remplace la propriété de base afin que, si aucune valeur de titre n’est fournie, un titre par défaut approprié à un PropertyGridEditorPart contrôle peut être fourni par le jeu de contrôles composants WebPart.

S’applique à

Voir aussi