Compartir a través de


IWebPart.CatalogIconImageUrl Propiedad

Definición

Obtiene o establece la dirección URL de una imagen que representa un control WebPart en un catálogo de controles.

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

Valor de propiedad

Una cadena que representa la dirección URL de una imagen que se utiliza para representar el control en un catálogo. El valor predeterminado es una cadena vacía ("").

Ejemplos

En el ejemplo de código siguiente se muestra el uso declarativo y mediante programación de la CatalogIconImageUrl propiedad . El código fuente completo del ejemplo se encuentra en la sección Ejemplo de la información general de la IWebPart clase.

La primera parte del ejemplo de código muestra cómo el control de usuario implementa la CatalogIconImageUrl propiedad .

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

La segunda parte del ejemplo de código muestra el método en el control de usuario que establece mediante programación el valor de la CatalogIconImageUrl propiedad cuando un usuario selecciona el nombre de propiedad adecuado de los botones de radio de la página, establece un nuevo valor en el cuadro de texto y, a continuación, hace clic en el botón Actualizar .

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

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

La tercera parte del ejemplo de código muestra cómo se hace referencia al control de usuario que implementa la IWebPart interfaz en un WebPartZone control y cómo se establece la CatalogIconImageUrl propiedad de forma declarativa en el control. Tenga en cuenta que, dado que no hay ningún catálogo de controles de elementos web proporcionados con este ejemplo, no puede ver el efecto real de establecer esta propiedad.

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

Comentarios

Las aplicaciones de elementos web suelen proporcionar un catálogo (o lista) de controles que los usuarios pueden agregar a una página. La CatalogIconImageUrl propiedad de un control contiene la dirección URL de una imagen que representa el control cuando aparece en un catálogo.

Se aplica a

Consulte también