Aracılığıyla paylaş

IWebPart.Subtitle Özellik

  • Başvuru

Tanım

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

Bir denetim için tam başlık 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 Örnek bölümünde IWebPart bulunur.

Kod örneğinin ilk bölümünde, kullanıcı denetiminin özelliği nasıl uyguladığı Subtitle gösterilir. Özelliğin salt okunur olduğunu ve bir denetimin ana başlığına eklenen varsayılan bir alt başlık sağlamak için kullanıldığını 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ü, 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ığını gösterir. Sayfayı bir tarayıcıda 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.