IWebPart.TitleUrl Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une URL vers des informations supplémentaires relatives à un contrôle WebPart.
public:
property System::String ^ TitleUrl { System::String ^ get(); void set(System::String ^ value); };public string TitleUrl { get; set; }member this.TitleUrl : string with get, setPublic Property TitleUrl As StringValeur de propriété
Chaîne qui représente une URL vers des informations supplémentaires relatives à un contrôle WebPart. La valeur par défaut est une chaîne vide ("").
Exemples
L’exemple de code suivant illustre l’utilisation déclarative et programmatique de la TitleUrl propriété . Le code source complet de l’exemple se trouve dans la section Exemple de la vue d’ensemble de la IWebPart classe.
La première partie de l’exemple de code montre comment le contrôle utilisateur implémente la TitleUrl propriété .
public string TitleUrl
{
get
{
object objTitle = ViewState["TitleUrl"];
if (objTitle == null)
return String.Empty;
return (string)objTitle;
}
set
{
ViewState["TitleUrl"] = value;
}
}
Public Property TitleUrl() As String _
Implements IWebPart.TitleUrl
Get
Dim objTitle As Object = ViewState("TitleUrl")
If objTitle Is Nothing Then
Return String.Empty
End If
Return CStr(objTitle)
End Get
Set(ByVal value As String)
ViewState("TitleUrl") = value
End Set
End Property
La deuxième partie de l’exemple de code illustre la méthode dans le contrôle utilisateur qui définit par programmation la valeur de la TitleUrl propriété lorsqu’un utilisateur sélectionne le nom de propriété approprié dans les cases d’option de la page, définit une nouvelle valeur dans la zone de texte, puis clique sur le bouton Mettre à jour .
Important
Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.
// 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
La troisième partie de l’exemple de code montre comment le contrôle utilisateur qui implémente l’interface IWebPart est référencé dans un WebPartZone contrôle et comment la TitleUrl propriété est définie de manière déclarative sur le contrôle. Notez que si vous ne fournissez pas d’URL vers une page réelle, puis qu’un utilisateur clique sur le lien dans la barre de titre, un message d’erreur s’affiche.
<%@ 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>
Remarques
Lorsque vous affectez une URL à la TitleUrl propriété, le titre du contrôle devient un lien. L’objectif de cette propriété est de fournir aux utilisateurs finaux un moyen pratique d’accéder à des informations supplémentaires sur un contrôle. Les informations supplémentaires peuvent fournir des données de copyright, des données de contact, des détails sur le créateur du contrôle ou un résumé de l’objectif du contrôle.
Notes
Normalement, vous n’utiliseriez pas la TitleUrl propriété pour lier au contenu de l’aide. La meilleure façon de fournir un lien vers l’aide d’un contrôle consiste à utiliser la HelpUrl propriété .
