PropertyGridEditorPart.Title Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene o imposta un titolo per il controllo 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

Valore della proprietà

String

Una stringa utilizzata come titolo del controllo. Il valore predefinito è un nome di controllo calcolato fornito dal set di controlli Web part.

Esempio

In questo esempio di codice viene illustrato come utilizzare la Title proprietà di un PropertyGridEditorPart controllo . Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento di panoramica della PropertyGridEditorPart classe.

Nell'esempio di codice seguente viene illustrato come impostare il titolo in un PropertyGridEditorPart controllo in modo dichiarativo in una pagina 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>

Nella parte successiva dell'esempio di codice viene illustrato come impostare il valore della Title proprietà a livello di codice. Per rendere persistente il valore assegnato a livello di codice, viene utilizzata una variabile statica denominata editControlTitle e questo valore viene assegnato alla Title proprietà ogni volta che il controllo viene inizializzato, in modo che il valore venga salvato in modo permanente tra gli eventi di 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 si carica la pagina in un browser, è possibile selezionare Modalità di modifica nel controllo elenco a discesa Modalità di visualizzazione per passare alla modalità di modifica. È possibile fare clic sul menu dei verbi (freccia verso il basso) nella barra del titolo del controllo WebPart Informazioni utente e fare clic su Modifica per iniziare la modifica. Quando l'interfaccia utente di modifica è visibile, è possibile visualizzare il PropertyGridEditorPart controllo e un pulsante e una casella di testo posizionata sopra. Si noti che il titolo del PropertyGridEditorPart controllo è il valore assegnato al controllo nel markup dichiarativo della pagina Web. Se si immette del testo nella casella di testo accanto al pulsante Update EditorPart Title e quindi si fa clic sul pulsante , il titolo del controllo viene aggiornato.

Commenti

Il valore della Title proprietà viene visualizzato nella barra del titolo di un PropertyGridEditorPart controllo quando il controllo è visibile in modalità di modifica. Quando il controllo viene dichiarato in una pagina, è possibile impostare un valore per l'attributo Title . Se non si specifica un valore per il titolo, viene fornito un valore predefinito specifico delle impostazioni cultura.

La Title proprietà esegue l'override della proprietà di base in modo che, se non viene specificato alcun valore di titolo, è possibile fornire un titolo predefinito appropriato a un PropertyGridEditorPart controllo dal set di controlli Web part.

Si applica a

Vedi anche