Part.Title Proprietà

Definizione

Ottiene o imposta il titolo di un controllo Web part.Gets or sets the title of a part control.

public:
 virtual property System::String ^ Title { System::String ^ get(); void set(System::String ^ value); };
public virtual string Title { get; set; }
member this.Title : string with get, set
Public Overridable Property Title As String

Valore della proprietà

Stringa che rappresenta il titolo del controllo Web part.A string that represents the title of the part control. Il valore predefinito è una stringa vuota ("").The default value is an empty string ("").

Esempi

Nell'esempio di codice seguente viene illustrato l'uso dichiarativo della proprietà Title in un controllo parte.The following code example illustrates the declarative use of the Title property in a part control. Questo esempio richiede l'TextDisplayWebPartdi controllo WebPart personalizzato, disponibile nella sezione esempio del riepilogo della classe Part.This example requires the custom WebPart control TextDisplayWebPart, which can be found in the Example section of the Part class summary.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Description="A text content WebPart control."
            ChromeType="TitleAndBorder"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      backcolor="#99cccc">
        <parttitlestyle font-bold="true" forecolor="#ffffff" />
        <partstyle
          borderwidth="1px" 
          borderstyle="Solid" 
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart2" 
            title = "Text Content WebPart 2" 
            Description="A text content WebPart control."
            ChromeType="TitleOnly"
            ChromeState="Minimized"
            width="350px" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Commenti

Il testo del titolo visibile nella barra del titolo di un controllo parte viene impostato dalla proprietà Title.The visible title text in a part control's title bar is set by the Title property. Il testo del titolo viene visualizzato anche come parte del testo della descrizione comando quando si posiziona il puntatore del mouse sulla barra del titolo di un controllo WebPart o su un altro controllo server visualizzato in una WebPartZone zona.The title text also appears as part of the ToolTip text when you position your mouse pointer over the title bar of a WebPart control or other server control that appears in a WebPartZone zone.

Lo stile del testo del titolo è determinato dalla proprietà PartTitleStyle della zona che contiene il controllo parte.The style of the title text is determined by the PartTitleStyle property of the zone that contains the part control.

Se non si specifica un titolo per un controllo, il set di controllo Web part calcola automaticamente una stringa predefinita da utilizzare come titolo.If you do not supply a title for a control, the Web Parts control set automatically calculates a default string to use as a title. Per altre informazioni, vedere DisplayTitle.For more information, see DisplayTitle. Inoltre, è possibile fornire un sottotitolo standard aggiunto alla stringa del titolo.Also, it is possible to provide a standard subtitle that is appended to the title string. Per informazioni dettagliate, vedere Subtitle.For details, see Subtitle.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse tramite uno strumento di progettazione.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Per ulteriori informazioni, vedere LocalizableAttribute e globalizzazione e localizzazione.For more information, see LocalizableAttribute and Globalization and Localization.

Note per gli eredi

Le classi derivate, ad esempio WebPart possono eseguire l'override di Title per consentire la personalizzazione dell'utente del titolo.Derived classes such as WebPart can override Title to enable user personalization of the title.

Si applica a

Vedi anche