PropertyGridEditorPart.Title Propriété

Définition

Obtient ou définit le titre du contrôle d'édition.Gets or sets a title for the editor control.

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.A string that is used as the title of the control. La valeur par défaut est un nom de contrôle calculé fourni par le jeu de contrôles WebPart.The default value is a calculated control name supplied by the Web Parts control set.

Exemples

Cet exemple de code montre comment utiliser la Title propriété d’un PropertyGridEditorPart contrôle.This code example demonstrates how to use the Title property of a PropertyGridEditorPart control. Pour obtenir le code complet nécessaire à l’exécution de l’exemple, consultez la section exemple de la PropertyGridEditorPart rubrique vue d’ensemble de la classe.For the full code required to run the example, see the Example section of the PropertyGridEditorPart class overview topic.

L’exemple de code suivant montre comment définir de façon déclarative le titre d’un PropertyGridEditorPart contrôle dans une page Web.The following code example shows how to set the title on a PropertyGridEditorPart control declaratively in a Web page.

<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.The next part of the code example shows how to set the value of the Title property programmatically. Afin de rendre persistante la valeur assignée par programmation, une variable statique nommée editControlTitle est utilisée et cette valeur est assignée à la Title propriété chaque fois que le contrôle est initialisé, afin que la valeur soit rendue persistante entre les événements de publication (postback).In order to persist the programmatically assigned value, a static variable named editControlTitle is used, and this value is assigned to the Title property each time the control is initialized, so that the value is persisted between postback events.

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 le mode d’édition dans le contrôle de liste déroulante mode d’affichage pour passer en mode édition.When you load the page in a browser, you can select Edit Mode in the Display Mode drop-down list control to switch to edit mode. Vous pouvez cliquer sur le menu des verbes (la flèche vers le bas) dans la barre de titre du contrôle WebPart des informations utilisateur , puis cliquer sur modifier pour commencer la modification.You can click the verbs menu (the downward arrow) in the title bar of the User Information WebPart control, and click Edit to begin editing. Lorsque l’interface utilisateur de modification est visible, vous pouvez voir le PropertyGridEditorPart contrôle, ainsi qu’un bouton et une zone de texte positionnés au-dessus.When the editing user interface (UI) is visible, you can see the PropertyGridEditorPart control, and a button and text box positioned above it. Notez que le titre du PropertyGridEditorPart contrôle est la valeur qui lui est assignée dans le balisage déclaratif de la page Web.Note that the title of the PropertyGridEditorPart control is the value assigned to it in the declarative markup of the Web page. Si vous entrez du texte dans la zone de texte en regard du bouton mettre à jour le titre EditorPart , puis cliquez sur le bouton, le titre du contrôle est mis à jour.If you enter some text in the text box next to the Update EditorPart Title button, and then click the button, the title for the control is updated.

Remarques

La Title valeur de la propriété est affichée dans la barre de titre d’un PropertyGridEditorPart contrôle lorsque le contrôle est visible en mode édition.The Title property value is displayed in the title bar of a PropertyGridEditorPart control when the control is visible in edit mode. Lorsque le contrôle est déclaré dans une page, vous pouvez définir une valeur pour l' Title attribut.When the control is declared in a page, you can set a value for the Title attribute. Si vous ne fournissez pas de valeur pour le titre, une valeur par défaut spécifique à la culture est fournie.If you do not supply a value for the title, a culture-specific default value is supplied.

La Title propriété se substitue à la propriété de base de sorte 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 WebParts.The Title property overrides the base property so that, if no title value is supplied, a default title appropriate to a PropertyGridEditorPart control can be supplied by the Web Parts control set.

S’applique à

Voir aussi