Freigeben über

WebPart.TitleIconImageUrl Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft die URL auf ein Bild ab, das zum Darstellen eines Webpart-Steuerelements in der Titelleiste des Steuerelements verwendet wird, oder legt diese fest.

public:
 virtual property System::String ^ TitleIconImageUrl { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)]
public virtual string TitleIconImageUrl { get; set; }
[<System.Web.UI.WebControls.WebParts.Personalizable(System.Web.UI.WebControls.WebParts.PersonalizationScope.Shared)>]
member this.TitleIconImageUrl : string with get, set
Public Overridable Property TitleIconImageUrl As String

Eigenschaftswert

String

Eine Zeichenfolge, die die URL zu einem Bild darstellt, das zum Darstellen des Steuerelements in der Titelleiste verwendet wird. Der Standardwert ist eine leere Zeichenfolge ("").

Implementiert

TitleIconImageUrl
Attribute
PersonalizableAttribute

Ausnahmen

ArgumentException

Das interne Überprüfungssystem hat festgestellt, dass die URL Skriptangriffe enthalten kann.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die TitleIconImageUrl Eigenschaft für ein benutzerdefiniertes Webpart-Steuerelement festgelegt wird, sodass das Steuerelement mit einem Bild in einem Steuerelementkatalog angezeigt wird. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas im Beispielabschnitt der WebPart Klassenübersicht erstellt wurde.

Notieren Sie sich im deklarativen Markup der Webseite das <aspSample:TextDisplayWebPart> Element. Dem TitleIconImageUrl Attribut wird eine Zeichenfolge zugewiesen, die die URL zu einer Bilddatei enthält. Laden Sie die Seite in einem Browser, und wenn Sie eine legitime URL zu einem Bild angegeben haben, wird das Bild in der Titelleiste des WebPart Steuerelements angezeigt.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>

<!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 id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            TitleIconImageUrl="MyImage.gif" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>

<!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 id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            TitleIconImageUrl="MyImage.gif" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Hinweise

Der Personalisierungsbereich dieser Eigenschaft ist auf Shared und kann nur von autorisierten Benutzern geändert werden. Weitere Informationen finden Sie unter PersonalizableAttribute " Übersicht über die Personalisierung von Webparts".

Gilt für:

Weitere Informationen