Share via


PropertyGridEditorPart.Title Propriedade

Definição

Obtém ou define um título para o controle do editor.

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

Valor da propriedade

Uma cadeia de caracteres que é usada como o título do controle. O valor padrão é um nome de controle calculado fornecido pelo conjunto de controle de Web Parts.

Exemplos

Este exemplo de código demonstra como usar a Title propriedade de um PropertyGridEditorPart controle . Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico visão geral da PropertyGridEditorPart classe.

O exemplo de código a seguir mostra como definir o título em um PropertyGridEditorPart controle declarativamente em uma página da 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>

A próxima parte do exemplo de código mostra como definir o valor da Title propriedade programaticamente. Para persistir o valor atribuído programaticamente, uma variável estática chamada editControlTitle é usada e esse valor é atribuído à Title propriedade sempre que o controle é inicializado, para que o valor seja persistido entre eventos de postback.

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

Ao carregar a página em um navegador, você pode selecionar Modo de Edição no controle de lista suspensa Modo de Exibição para alternar para o modo de edição. Você pode clicar no menu de verbos (a seta para baixo) na barra de título do controle WebPart de Informações do Usuário e clicar em Editar para começar a edição. Quando a interface do usuário de edição estiver visível, você poderá ver o PropertyGridEditorPart controle e um botão e uma caixa de texto posicionados acima dele. Observe que o título do PropertyGridEditorPart controle é o valor atribuído a ele na marcação declarativa da página da Web. Se você inserir algum texto na caixa de texto ao lado do botão Atualizar EditorPart Title e clicar no botão , o título do controle será atualizado.

Comentários

O Title valor da propriedade é exibido na barra de título de um PropertyGridEditorPart controle quando o controle está visível no modo de edição. Quando o controle é declarado em uma página, você pode definir um valor para o Title atributo . Se você não fornecer um valor para o título, um valor padrão específico da cultura será fornecido.

A Title propriedade substitui a propriedade base para que, se nenhum valor de título for fornecido, um título padrão apropriado a um PropertyGridEditorPart controle possa ser fornecido pelo conjunto de controle de Web Parts.

Aplica-se a

Confira também