IWebPart.Subtitle プロパティ
アセンブリ: System.Web (system.web.dll 内)


Subtitle プロパティは、タイトル バー上のコントロールのタイトルに追加される WebPart コントロールの既定のサブタイトル文字列を返すために使用されます。
IWebPart インターフェイスを実装するコントロールの Subtitle プロパティの既定値を指定する場合、Web パーツ コントロール セットは、実行時に、その値をコントロールの Title プロパティの値に自動的に追加します。

Subtitle プロパティを、宣言で使用する方法およびプログラムで使用する方法を示すコード例を次に示します。この例の完全なソース コードは、IWebPart の概要にある「例」のセクションを参照してください。
コード例の最初の部分は、ユーザー コントロールにおける Subtitle プロパティの実装方法を示しています。このプロパティは読み取り専用で、コントロールのメイン タイトルに追加される既定のサブタイトルを提供するために使用されます。
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
public string Subtitle { get { object objSubTitle = ViewState["Subtitle"]; if (objSubTitle == null) return "My Subtitle"; return (string)objSubTitle; } }
コード例の 2 番目の部分は、IWebPart インターフェイスを実装するユーザー コントロールを WebPartZone コントロールから参照する方法と、コントロールに対して IWebPart から書き込み可能なプロパティを宣言によって設定する方法を示しています。ブラウザにページを読み込むと、ユーザー コントロールの実装コードで設定された Subtitle プロパティの既定値が、コントロールのタイトル バーのタイトルに追加されます。
<%@ page language="VB" %> <%@ register tagprefix="uc1" tagname="AccountUserControlVB" src="AccountUserControlvb.ascx"%> <html> <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>
<%@ page language="c#" %> <%@ register tagprefix="uc1" tagname="AccountUserControlCS" src="AccountUserControlcs.ascx"%> <html> <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>

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Weblioに収録されているすべての辞書からIWebPart.Subtitle プロパティを検索する場合は、下記のリンクをクリックしてください。

- IWebPart.Subtitle プロパティのページへのリンク