IWebPart.CatalogIconImageUrl Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Denetim kataloğundaki bir denetimi temsil eden bir WebPart görüntünün URL'sini alır veya ayarlar.
public:
property System::String ^ CatalogIconImageUrl { System::String ^ get(); void set(System::String ^ value); };public string CatalogIconImageUrl { get; set; }member this.CatalogIconImageUrl : string with get, setPublic Property CatalogIconImageUrl As StringÖzellik Değeri
Katalogdaki denetimi temsil etmek için kullanılan görüntünün URL'sini temsil eden dize. Varsayılan değer boş bir dizedir ("").
Örnekler
Aşağıdaki kod örneği, özelliğinin bildirim temelli ve programlı kullanımını CatalogIconImageUrl gösterir. Örneğin tam kaynak kodu, sınıfa genel bakışın IWebPart Örnek bölümünde bulunur.
Kod örneğinin ilk bölümü, kullanıcı denetiminin özelliğini nasıl uyguladığını CatalogIconImageUrl gösterir.
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
Kod örneğinin ikinci bölümünde, kullanıcı sayfadaki radyo düğmelerinden uygun özellik adını seçtiğinde, metin kutusunda yeni bir değer ayarlayıp Güncelleştir düğmesine tıkladığında, kullanıcı denetiminde özelliğin değerini CatalogIconImageUrl program aracılığıyla ayarlayan yöntemi gösterilir.
Önemli
Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.
// 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
Kod örneğinin üçüncü bölümü, arabirimi uygulayan kullanıcı denetimine IWebPart bir WebPartZone denetimde nasıl başvurulduğunu ve özelliğin CatalogIconImageUrl denetimde bildirim temelli olarak nasıl ayarlandığını gösterir. Bu örnekte sağlanan Web Bölümleri denetimleri kataloğu olmadığından, bu özelliği ayarlamanın gerçek etkisini göremediğini unutmayın.
<%@ 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>
Açıklamalar
Web Bölümleri uygulamaları genellikle kullanıcıların sayfaya ekleyebilecekleri bir denetim kataloğu (veya listesi) sağlar. Denetimdeki CatalogIconImageUrl özelliği, bir katalogda göründüğünde denetimi temsil eden görüntünün URL'sini içerir.
