WebPart.TitleUrl Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtient ou définit une URL vers des informations supplémentaires relatives à un contrôle WebPart.

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

Valeur de propriété

String

Chaîne qui représente une URL vers des informations supplémentaires relatives au contrôle WebPart. La valeur par défaut est une chaîne vide ("").

Implémente

TitleUrl
Attributs
ThemeableAttribute PersonalizableAttribute

Exceptions

ArgumentException

Le système de validation interne a déterminé que l'URL peut contenir des attaques de script.

Exemples

L’exemple de code suivant montre comment définir la TitleUrl propriété pour un contrôle de composants WebPart personnalisé. Cet exemple suppose l’utilisation d’un contrôle personnalisé, TextDisplayWebPartqui se trouve dans la section Exemple de la vue d’ensemble de la WebPart classe.

Notez que l’élément <aspSample:TextDisplayWebPart> contient l’attribut TitleUrl avec une URL fictive. Si vous chargez la page dans un navigateur, le titre du WebPart contrôle est maintenant un lien vers la ressource pointée par la TitleUrl propriété.

<%@ 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" 
            TitleUrl="HelpFile.htm"
            />
          </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" 
            TitleUrl="HelpFile.htm"
            />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Remarques

Lorsque vous attribuez une URL à la TitleUrl propriété, le titre du contrôle devient un lien vers des informations supplémentaires sur le contrôle. L’URL n’est pas affichée lorsque la page est en mode d’affichage où les contrôles peuvent être déplacés, tels que la conception, la modification ou le mode catalogue.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et peaux.

L’étendue de personnalisation de cette propriété est définie Shared et peut être modifiée uniquement par les utilisateurs autorisés. Pour plus d’informations, consultez PersonalizableAttribute et composants WebPart vue d’ensemble de la personnalisation.

S’applique à

Voir aussi