Aracılığıyla paylaş

IWebPart.TitleIconImageUrl Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Denetimin kendi başlık çubuğunda web bölümleri denetimini temsil etmek için kullanılan görüntünün URL'sini alır veya ayarlar.

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

Özellik Değeri

String

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ı TitleIconImageUrl gösterir. Örneğin tam kaynak kodu, sınıfa genel bakışın Örnek bölümünde IWebPart bulunur.

Kod örneğinin ilk bölümünde, kullanıcı denetiminin özelliği nasıl uyguladığı TitleIconImageUrl gösterilir.

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

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 ayarladığında ve ardından Güncelleştir düğmesine tıkladığında özelliğin değerini TitleIconImageUrl program aracılığıyla ayarlayan kullanıcı denetimindeki 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 TitleIconImageUrl denetimde bildirim temelli olarak nasıl ayarlandığını gösterir. Gerçek bir resmin URL'sini sağlamazsanız, başlık çubuğunda simge için bir yer tutucu gösterildiğ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

TitleIconImageUrl özelliği, bir simgeyi bir denetimle ilişkilendirmek için bir WebPart yol sağlar. Simge, denetimin kendi başlık çubuğunda görünür. Tematik tutarlılık için, uygulama geliştiricileri bu simgeyi Web Bölümleri denetimleri kataloğundaki denetimi temsil eden görüntüye (özelliğinde CatalogIconImageUrl başvuruda bulunılan görüntü) benzer hale getirmek isteyebilir.

Web Bölümleri denetim kümesinde uygulandığından, özellik denetimin TitleIconImageUrl başlık çubuğunda görünen resmi veya simgeyi değiştirmek için son kullanıcılar tarafından kişiselleştirilebilir.

Şunlara uygulanır

Ayrıca bkz.