IWebPart.CatalogIconImageUrl プロパティ

定義

コントロールのカタログで WebPart コントロールを表すイメージの URL を取得または設定します。

public:
 property System::String ^ CatalogIconImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string CatalogIconImageUrl { get; set; }
member this.CatalogIconImageUrl : string with get, set
Public Property CatalogIconImageUrl As String

プロパティ値

カタログ内でコントロールを表すために使用されるイメージへの URL を表す文字列。 既定値は空の文字列 ("") です。

次のコード例では、 プロパティの宣言型およびプログラムによる使用を CatalogIconImageUrl 示します。 この例の完全なソース コードについては、クラスの概要の「例」セクションを IWebPart 参照してください。

コード例の最初の部分では、ユーザー コントロールが プロパティを実装する方法を CatalogIconImageUrl 示します。

public string CatalogIconImageUrl
{
  get
  {
    object objTitle = ViewState["CatalogIconImageUrl"];
    if (objTitle == null)
      return String.Empty;

    return (string)objTitle;
  }
  set
  {
    ViewState["CatalogIconImageUrl"] = value;
  }
}
Public Property CatalogIconImageUrl() As String _
  Implements IWebPart.CatalogIconImageUrl
  Get
    Dim objTitle As Object = ViewState("CatalogIconImageUrl")
    If objTitle Is Nothing Then
      Return String.Empty
    End If
    Return CStr(objTitle)
  End Get
  Set(ByVal value As String)
    ViewState("CatalogIconImageUrl") = value
  End Set
End Property

コード例の 2 番目の部分では、ユーザーがページ上のラジオ ボタンから適切なプロパティ名を選択し、テキスト ボックスに新しい値を設定し、[更新] ボタンをクリックしたときに、プロパティのCatalogIconImageUrl値をプログラムによって設定する、ユーザー コントロールの メソッドを示します。

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。

// 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;
  }
}
' 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

コード例の 3 番目の部分では、インターフェイスを実装 IWebPart するユーザー コントロールをコントロールで参照する方法と、コントロールに WebPartZone 対してプロパティを CatalogIconImageUrl 宣言的に設定する方法を示します。 この例で提供されている Web パーツ コントロールのカタログがないため、このプロパティを設定した場合の実際の効果を確認できないことに注意してください。

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

注釈

Web パーツ アプリケーションは、多くの場合、ユーザーがページに追加できるコントロールのカタログ (またはリスト) を提供します。 CatalogIconImageUrlコントロールの プロパティには、カタログに表示されるコントロールを表すイメージへの URL が含まれます。

適用対象

こちらもご覧ください