Partager via


PropertyGridEditorPart.Title Propriété

Définition

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é

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 d’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 Mode d’édition dans le contrôle de liste déroulante Mode d’affichage pour passer en mode édition. Vous pouvez cliquer sur le menu verbes (flèche vers le bas) dans la barre de titre du contrôle User Information WebPart , puis cliquer sur Modifier pour commencer la modification. Lorsque l’interface utilisateur de modification est visible, vous pouvez voir le PropertyGridEditorPart contrôle, ainsi qu’un bouton et une zone de texte placés au-dessus de celui-ci. Notez que le titre du PropertyGridEditorPart contrôle est la valeur qui lui est 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 l’éditeurPart Title , puis cliquez sur le bouton, le titre du contrôle est mis à jour.

Remarques

La Title valeur de la 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 puisse être fourni par le jeu de contrôles WebPart.

S’applique à

Voir aussi