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

WebPart コントロールの詳細情報への URL を表す文字列。既定値は空の文字列 ("") です。

URL を TitleUrl プロパティに代入すると、コントロールのタイトルがリンクになります。このプロパティの目的は、エンド ユーザーがコントロールの追加情報に簡単にアクセスできるようにすることです。追加情報では、著作権データ、連絡先情報、コントロールの作成者についての詳細情報、またはコントロールの目的の概要を提供できます。
![]() |
---|
通常、ヘルプの内容へのリンクには TitleUrl プロパティは使用できません。コントロールのヘルプへのリンクを提供するには、HelpUrl プロパティを使用する方法が最適です。 |

TitleUrl プロパティを、宣言で使用する方法およびプログラムで使用する方法を示すコード例を次に示します。この例の完全なソース コードは、IWebPart の概要にある「例」のセクションを参照してください。
コード例の最初の部分は、ユーザー コントロールにおける TitleUrl プロパティの実装方法を示しています。
Public Property TitleUrl() As String _ Implements IWebPart.TitleUrl Get Dim objTitle As Object = ViewState("TitleUrl") If objTitle Is Nothing Then Return String.Empty End If Return CStr(objTitle) End Get Set(ByVal value As String) ViewState("TitleUrl") = value End Set End Property
public string TitleUrl { get { object objTitle = ViewState["TitleUrl"]; if (objTitle == null) return String.Empty; return (string)objTitle; } set { ViewState["TitleUrl"] = value; } }
コード例の 2 番目の部分は、ユーザー コントロールにおけるメソッドの使用を示しています。ユーザーがページ上のオプション ボタンから適切なプロパティ名を選択し、テキスト ボックスに新しい値を入力して [更新] ボタンをクリックすると、TitleUrl プロパティの値がプログラムから設定されます。
' Update the selected IWebPart property value. Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) Dim propertyValue As String = Server.HtmlEncode(TextBox3.Text) TextBox3.Text = String.Empty Select Case RadioButtonList1.SelectedValue Case "title" Me.Title = propertyValue Case "description" Me.Description = propertyValue Case "catalogiconimageurl" Me.CatalogIconImageUrl = propertyValue Case "titleiconimageurl" Me.TitleIconImageUrl = propertyValue Case "titleurl" Me.TitleUrl = propertyValue Case Else End Select End Sub 'Button1_Click
// Update the selected IWebPart property value. void Button1_Click(object sender, EventArgs e) { String propertyValue = Server.HtmlEncode(TextBox3.Text); TextBox3.Text = String.Empty; switch (RadioButtonList1.SelectedValue) { case "title": this.Title = propertyValue; break; case "description": this.Description = propertyValue; break; case "catalogiconimageurl": this.CatalogIconImageUrl = propertyValue; break; case "titleiconimageurl": this.TitleIconImageUrl = propertyValue; break; case "titleurl": this.TitleUrl = propertyValue; break; default: break; } }
コード例の 3 番目の部分は、IWebPart インターフェイスを実装するユーザー コントロールを WebPartZone コントロールから参照する方法と、コントロールに対して TitleUrl プロパティを宣言によって設定する方法を示しています。実際のページへの URL を指定していない場合にユーザーがリンクをクリックすると、エラー メッセージが表示されます。
<%@ 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.TitleUrl プロパティを検索する場合は、下記のリンクをクリックしてください。

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