IWebPart.TitleUrl Eigenschap

Definitie

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

Hiermee wordt een URL opgehaald of ingesteld op aanvullende informatie over een WebPart besturingselement.

public:
 property System::String ^ TitleUrl { System::String ^ get(); void set(System::String ^ value); };
public string TitleUrl { get; set; }
member this.TitleUrl : string with get, set
Public Property TitleUrl As String

Waarde van eigenschap

String

Een tekenreeks die een URL vertegenwoordigt voor meer informatie over een WebPart besturingselement. De standaardwaarde is een lege tekenreeks ("").

Voorbeelden

In het volgende codevoorbeeld ziet u het declaratieve en programmatische gebruik van de TitleUrl eigenschap. De volledige broncode voor het voorbeeld vindt u in de sectie Voorbeeld van het IWebPart klassenoverzicht.

In het eerste deel van het codevoorbeeld ziet u hoe het gebruikersbesturingselement de TitleUrl eigenschap implementeert.

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

In het tweede deel van het codevoorbeeld ziet u de methode in het gebruikersbesturingselement waarmee de waarde van de TitleUrl eigenschap via een programma wordt ingesteld wanneer een gebruiker de juiste eigenschapsnaam selecteert in de keuzerondjes op de pagina, een nieuwe waarde instelt in het tekstvak en vervolgens op de knop Bijwerken klikt.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

// 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

Het derde deel van het codevoorbeeld laat zien hoe het gebruikersbesturingselement dat de IWebPart interface implementeert, wordt verwezen in een WebPartZone besturingselement en hoe de TitleUrl eigenschap declaratief wordt ingesteld op het besturingselement. Als u geen URL naar een echte pagina opgeeft en een gebruiker vervolgens op de koppeling in de titelbalk klikt, wordt er een foutbericht weergegeven.

<%@ 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>

Opmerkingen

Wanneer u een URL aan de TitleUrl eigenschap toewijst, wordt de titel van het besturingselement een koppeling. Het doel van deze eigenschap is om eindgebruikers een handige manier te bieden om toegang te krijgen tot aanvullende informatie over een besturingselement. De aanvullende informatie kan copyrightgegevens, contactgegevens, details over de maker van het besturingselement of een samenvatting van het doel van het besturingselement verstrekken.

Note

Normaal gesproken gebruikt u de TitleUrl eigenschap niet om een koppeling naar Help-inhoud te maken. De beste manier om een koppeling naar Help voor een besturingselement op te geven, is door de HelpUrl eigenschap te gebruiken.

Van toepassing op

Zie ook