Sdílet prostřednictvím

IWebPart.Subtitle Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá řetězec, který je zřetězen s Title hodnotou vlastnosti vytvořit úplný název ovládacího prvku WebPart .

public:
 property System::String ^ Subtitle { System::String ^ get(); };
public string Subtitle { get; }
member this.Subtitle : string
Public ReadOnly Property Subtitle As String

Hodnota vlastnosti

String

Řetězec, který slouží jako podnadpis ovládacího prvku. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující příklad kódu ukazuje deklarativní a programové použití Subtitle vlastnosti. Úplný zdrojový kód pro příklad najdete v části Příklad v přehledu IWebPart třídy.

První část příkladu kódu ukazuje, jak uživatelský ovládací prvek implementuje Subtitle vlastnost. Všimněte si, že vlastnost je jen pro čtení a je určena k poskytnutí výchozího podnadpisu, který je připojen k hlavnímu názvu ovládacího prvku.

public string Subtitle
{
  get
  {
    object objSubTitle = ViewState["Subtitle"];
    if (objSubTitle == null)
      return "My Subtitle";

    return (string)objSubTitle;
  }

}

ReadOnly Property Subtitle() As String _
  Implements IWebPart.Subtitle
  Get
    Dim objSubTitle As Object = ViewState("Subtitle")
    If objSubTitle Is Nothing Then
      Return "My Subtitle"
    End If
    Return CStr(objSubTitle)
  End Get
End Property

Druhá část příkladu kódu ukazuje, jak se na uživatelský ovládací prvek, který implementuje IWebPart rozhraní, odkazuje v ovládacím WebPartZone prvku a jak jsou zapisovatelné vlastnosti z IWebPart ovládacího prvku nastaveny deklarativně. Po načtení stránky v prohlížeči si všimněte, že výchozí hodnota Subtitle vlastnosti, která byla nastavena v kódu implementace uživatelského ovládacího prvku, je připojena k názvu v záhlaví ovládacího prvku.

<%@ page language="c#" %>
<%@ register tagprefix="uc1" 
    tagname="AccountUserControlCS" 
    src="AccountUserControlcs.ascx"%>
<!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 runat="server">
    <title>
      Personalizable User Control with IWebPart Properties
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
      <asp:webpartzone 
        id="zone1" 
        runat="server" 
        headertext="Main" 
        CloseVerb-Enabled="false">
        <zonetemplate>
          <uc1:AccountUserControlCS 
            runat="server" 
            id="accountwebpart" 
            title="Account Form"
            Description="Account Form with default values."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconImageUrl="MyTitleIcon.gif"
            TitleUrl="MyUrl.html"/>
        </zonetemplate>
      </asp:webpartzone>    
    </form>
  </body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="AccountUserControlVB" 
    src="AccountUserControlvb.ascx"%>
<!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 runat="server">
    <title>
      Personalizable User Control with IWebPart Properties
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
      <asp:webpartzone 
        id="zone1" 
        runat="server" 
        headertext="Main" 
        CloseVerb-Enabled="false">
        <zonetemplate>
          <uc1:AccountUserControlVB 
            runat="server" 
            id="accountwebpart" 
            title="Account Form"
            Description="Account Form with default values."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconImageUrl="MyTitleIcon.gif"
            TitleUrl="MyUrl.html"/>
        </zonetemplate>
      </asp:webpartzone>    
    </form>
  </body>
</html>

Poznámky

Vlastnost Subtitle se používá k vrácení výchozího řetězce titulků WebPart pro ovládací prvek, který je připojen k názvu ovládacího prvku v záhlaví.

Pokud zadáte výchozí hodnotu pro Subtitle vlastnost v ovládacím prvku, který implementuje IWebPart rozhraní, sada ovládacích Title prvků webových částí automaticky připojí k hodnotě vlastnosti ovládacího prvku za běhu.

Platí pro

Viz také