IWebPart.TitleIconImageUrl Propriedade
Definição
Obtém ou define a URL para uma imagem usada para representar um controle de Web Parts na barra de título do próprio controle.Gets or sets the URL to an image used to represent a Web Parts control in the control's own title bar.
public:
property System::String ^ TitleIconImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string TitleIconImageUrl { get; set; }
member this.TitleIconImageUrl : string with get, set
Public Property TitleIconImageUrl As String
Valor da propriedade
Uma cadeia de caracteres que representa a URL para uma imagem.A string that represents the URL to an image. O valor padrão é uma cadeia de caracteres vazia ("").The default value is an empty string ("").
Exemplos
O exemplo de código a seguir demonstra o uso declarativa e programático da TitleIconImageUrl propriedade.The following code example demonstrates declarative and programmatic use of the TitleIconImageUrl property. O código-fonte completo do exemplo é encontrado na seção de exemplo da IWebPart classe visão geral.The complete source code for the example is found in the Example section of the IWebPart class overview.
A primeira parte do exemplo de código mostra como o controle de usuário implementa a TitleIconImageUrl propriedade.The first part of the code example shows how the user control implements the TitleIconImageUrl property.
public string TitleIconImageUrl
{
get
{
object objTitle = ViewState["TitleIconImageUrl"];
if (objTitle == null)
return String.Empty;
return (string)objTitle;
}
set
{
ViewState["TitleIconImageUrl"] = value;
}
}
Public Property TitleIconImageUrl() As String _
Implements IWebPart.TitleIconImageUrl
Get
Dim objTitle As Object = ViewState("TitleIconImageUrl")
If objTitle Is Nothing Then
Return String.Empty
End If
Return CStr(objTitle)
End Get
Set(ByVal value As String)
ViewState("TitleIconImageUrl") = value
End Set
End Property
A segunda parte do exemplo de código demonstra o método no controle de usuário que define programaticamente o valor da TitleIconImageUrl propriedade quando um usuário seleciona o nome de propriedade apropriado nos botões de opção na página, define um novo valor na caixa de texto e clica no botão Atualizar .The second part of the code example demonstrates the method in the user control that programmatically sets the value of the TitleIconImageUrl property when a user selects the appropriate property name from the radio buttons on the page, sets a new value in the text box, and then clicks the Update button.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança.This example has a text box that accepts user input, which is a potential security threat. Por padrão, as páginas da Web do ASP.NET validam que a entrada do usuário não inclui elementos de script ou HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.
// 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
A terceira parte do exemplo de código mostra como o controle de usuário que implementa a IWebPart interface é referenciado em um WebPartZone controle e como a TitleIconImageUrl propriedade é definida declarativamente no controle.The third part of the code example shows how the user control that implements the IWebPart interface is referenced in a WebPartZone control, and how the TitleIconImageUrl property is set declaratively on the control. Observe que, se você não fornecer a URL para uma imagem real, um espaço reservado para o ícone aparecerá na barra de título.Note that if you do not provide the URL to a real image, a placeholder for the icon appears in the title bar.
<%@ 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>
Comentários
A TitleIconImageUrl propriedade fornece uma maneira de associar um ícone a um WebPart controle.The TitleIconImageUrl property provides a way to associate an icon with a WebPart control. O ícone aparece na barra de título do próprio controle.The icon appears in the control's own title bar. Para a consistência de temática, os desenvolvedores de aplicativos podem querer tornar esse ícone semelhante à imagem que representa o controle em um catálogo de controles de Web Parts (a imagem referenciada na CatalogIconImageUrl Propriedade).For thematic consistency, application developers might want to make this icon similar to the image that represents the control in a catalog of Web Parts controls (the image referenced in the CatalogIconImageUrl property).
Como ele é implementado no conjunto de controle de Web Parts, a TitleIconImageUrl propriedade pode ser personalizada pelos usuários finais para alterar a imagem ou o ícone que aparece na barra de título de um controle.As it is implemented in the Web Parts control set, the TitleIconImageUrl property can be personalized by end users to change the image or icon that appears in a control's title bar.