WebPart.TitleUrl Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece una dirección URL de información complementaria sobre un control 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
Valor de propiedad
Una cadena que representa una dirección URL con información adicional sobre el control WebPart. El valor predeterminado es una cadena vacía ("").
Implementaciones
- Atributos
Excepciones
El sistema interno de validación ha determinado que la dirección URL puede contener ataques mediante script.
Ejemplos
En el ejemplo de código siguiente se muestra cómo establecer la TitleUrl propiedad para un control de elementos web personalizados. En este ejemplo se supone el uso de un control personalizado, TextDisplayWebPart
, que se encuentra en la sección Ejemplo de la información general de la WebPart clase.
Observe que el <aspSample:TextDisplayWebPart>
elemento contiene el TitleUrl
atributo con una dirección URL ficticia. Si carga la página en un explorador, el título del WebPart control ahora es un vínculo al recurso al que apunta la TitleUrl propiedad .
<%@ 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>
Comentarios
Al asignar una dirección URL a la TitleUrl propiedad , el título del control se convierte en un vínculo a información complementaria sobre el control. La dirección URL no se representa cuando la página está en modo de presentación donde se pueden arrastrar los controles, como el diseño, la edición o el modo de catálogo.
Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, consulte ThemeableAttribute y ASP.NET Temas y máscaras.
El ámbito de personalización de esta propiedad se establece en Shared y solo los usuarios autorizados pueden modificarlos. Para obtener más información, vea PersonalizableAttribute y Información general sobre personalización de elementos web.