WebPart.TitleIconImageUrl Eigenschaft

  • Referenz

Definition

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

Ruft die URL eines Bilds ab, mit dem ein Webparts-Steuerelement auf dessen eigener Titelleiste dargestellt 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 eines Bilds darstellt, mit dem das Steuerelement auf dessen eigener Titelleiste dargestellt wird. Der Standardwert ist eine leere Zeichenfolge ("").

Implementiert

TitleIconImageUrl
Attribute
PersonalizableAttribute

Ausnahmen

ArgumentException

Das interne Validierungssystem hat ermittelt, dass die URL Skriptangriffe enthalten könnte.

Beispiele

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

Beachten Sie im deklarativen Markup der Webseite das <aspSample:TextDisplayWebPart> Element. Sein TitleIconImageUrl Attribut wird einer 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 bereitgestellt 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 festgelegt Shared und kann nur von autorisierten Benutzern geändert werden. Weitere Informationen finden Sie unter PersonalizableAttribute und Webparts Übersicht über die Personalisierung.

Gilt für

Siehe auch