Idioma

PropertyGridEditorPart.Title Propriedade

Definição

Recebe ou define um título para o controlo 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 de Propriedade

Uma corda que é usada como nome do controlo. O valor padrão é um nome de controlo calculado fornecido pelo conjunto de controlos Web Parts.

Exemplos

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

O exemplo de código seguinte mostra como definir o título num PropertyGridEditorPart controlo de forma declarativa numa página 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 parte seguinte do exemplo de código mostra como definir o valor da Title propriedade programaticamente. Para persistir o valor atribuído programaticamente, é usada uma variável estática nomeada editControlTitle , e este valor é atribuído à Title propriedade cada vez que o controlo é inicializado, de modo a que o valor persiste 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

Quando carregas a página num navegador, podes selecionar Modo Editar no menu suspenso de controlo da lista para mudar para o modo de edição. Pode clicar no menu de verbos (a seta para baixo) na barra de título do controlo da WebPart de Informação do Utilizador e clicar em Editar para começar a editar. Quando a interface de edição (UI) está visível, pode ver o PropertyGridEditorPart controlo, um botão e uma caixa de texto posicionados acima dela. Note que o título do PropertyGridEditorPart controlo é o valor atribuído a ele na marcação declarativa da página Web. Se inserires algum texto na caixa de texto ao lado do botão Atualizar Editor Part Title e depois clicares no botão, o título do controlo é atualizado.

Observações

O valor da Title propriedade é apresentado na barra de título de um PropertyGridEditorPart controlo quando este está visível em modo de edição. Quando o controlo é declarado numa página, pode definir um valor para o Title atributo. Se não fornecer um valor para o título, é fornecido um valor padrão específico da cultura.

A Title propriedade sobrepõe-se à propriedade base, de modo que, se não for fornecido valor de título, um título padrão apropriado a um PropertyGridEditorPart controlo pode ser fornecido pelo conjunto de controlos Web Parts.

Aplica-se a

Consulte também