Aracılığıyla paylaş

IWebPart.Subtitle Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Bir denetimin tam başlığını oluşturmak üzere özellik değeriyle Title birleştirilmiş bir WebPart dize alır.

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

Özellik Değeri

String

Denetim için alt başlık görevi görecek bir dize. Varsayılan değer boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, özelliğinin bildirim temelli ve programlı kullanımını Subtitle gösterir. Örneğin tam kaynak kodu, sınıfa genel bakışın IWebPart Örnek bölümünde bulunur.

Kod örneğinin ilk bölümü, kullanıcı denetiminin özelliğini nasıl uyguladığını Subtitle gösterir. Özelliğin salt okunur olduğunu ve denetimin ana başlığına eklenen varsayılan bir alt başlık sağlamak için kullanılması gerektiğini unutmayın.

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

Kod örneğinin ikinci bölümünde, arabirimi uygulayan kullanıcı denetimine IWebPart bir WebPartZone denetimde nasıl başvurulduğunu ve yazılabilir özelliklerin IWebPart denetim üzerinde bildirim temelli olarak nasıl ayarlandığı gösterilir. Sayfayı bir tarayıcıya yükledikten sonra, kullanıcı denetiminin Subtitle uygulama kodunda ayarlanan özelliğin varsayılan değerinin denetimin başlık çubuğunda başlığa eklendiğini unutmayın.

<%@ 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>

Açıklamalar

Subtitle özelliği, başlık çubuğunda denetimin başlığına eklenen bir WebPart denetimin varsayılan alt başlık dizesini döndürmek için kullanılır.

Arabirimi uygulayan IWebPart bir denetimde özelliği için Subtitle varsayılan bir değer sağlarsanız, Web Bölümleri denetim kümesi bunu otomatik olarak çalışma zamanında denetimin özelliğinin değerine Title ekler.

Şunlara uygulanır

Ayrıca bkz.