Udostępnij za pośrednictwem

IWebPart.CatalogIconImageUrl Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Pobiera lub ustawia adres URL na obraz reprezentujący kontrolkę WebPart w wykazie kontrolek.

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

Wartość właściwości

String

Ciąg reprezentujący adres URL obrazu używanego do reprezentowania kontrolki w wykazie. Wartością domyślną jest ciąg pusty ("").

Przykłady

W poniższym przykładzie kodu pokazano deklaratywne i programowe użycie CatalogIconImageUrl właściwości . Kompletny kod źródłowy przykładu znajduje się w sekcji Przykład w przeglądzie IWebPart klasy.

Pierwsza część przykładu kodu pokazuje, jak kontrolka CatalogIconImageUrl użytkownika implementuje właściwość .

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

Druga część przykładu kodu demonstruje metodę w kontrolce użytkownika, która programowo ustawia wartość CatalogIconImageUrl właściwości, gdy użytkownik wybierze odpowiednią nazwę właściwości z przycisków radiowych na stronie, ustawia nową wartość w polu tekstowym, a następnie klika przycisk Aktualizuj .

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

// 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

Trzecia część przykładu kodu pokazuje, w jaki sposób kontrolka użytkownika, która implementuje IWebPart interfejs, jest przywołyny w kontrolce WebPartZone i jak CatalogIconImageUrl właściwość jest ustawiana deklaratywnie na kontrolce. Należy pamiętać, że ponieważ w tym przykładzie nie ma wykazu kontrolek składników Web Part, nie można zobaczyć rzeczywistego efektu ustawienia tej właściwości.

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

Uwagi

Aplikacje składników Web Part często udostępniają wykaz (lub listę) kontrolek, które użytkownicy mogą dodawać do strony. Właściwość CatalogIconImageUrl kontrolki zawiera adres URL obrazu reprezentującego kontrolkę po wyświetleniu jej w wykazie.

Dotyczy

Zobacz też