다음을 통해 공유

IWebPart.Subtitle 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls.WebParts
어셈블리:
System.Web.dll

Title 컨트롤의 전체 제목을 구성하기 위해 WebPart 속성 값에 연결된 문자열을 가져옵니다.

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

속성 값

String

컨트롤의 부제목으로 사용되는 문자열입니다. 기본값은 빈 문자열("")입니다.

예제

다음 코드 예제에서는 선언적이 고 프로그래밍 방식으로 사용 하는 Subtitle 속성입니다. 예제의 전체 소스 코드는 클래스 개요의 예제 섹션에 있습니다 IWebPart .

코드 예제의 첫 번째 부분에서는 사용자 컨트롤이 속성을 구현하는 방법을 보여 줍니다 Subtitle . 속성은 읽기 전용이며 컨트롤의 주 제목에 추가되는 기본 자막을 제공하는 데 사용됩니다.

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

코드 예제의 두 번째 부분은 인터페이스를 구현 IWebPart 하는 사용자 컨트롤이 컨트롤에서 WebPartZone 참조되는 방법과 의 쓰기 가능한 속성 IWebPart 이 컨트롤에서 선언적으로 설정되는 방법을 보여 줍니다. 브라우저에서 페이지를 로드한 후 사용자 컨트롤의 Subtitle 구현 코드에 설정된 속성의 기본값이 컨트롤의 제목 표시줄에 제목에 추가됩니다.

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

설명

속성 제목 Subtitle 표시줄에서 컨트롤의 제목에 추가 되는 컨트롤에 대 한 WebPart 기본 자막 문자열을 반환 하는 데 사용 됩니다.

인터페이스를 구현 IWebPart 하는 컨트롤에서 속성의 Subtitle 기본값을 제공하는 경우 웹 파트 컨트롤 집합은 런타임에 컨트롤의 Title 속성 값에 자동으로 추가합니다.

적용 대상

추가 정보