GenericWebPart.TitleUrl Propriedade

Definição

Obtém ou define uma URL para informações complementares sobre um controle GenericWebPart.Gets or sets a URL to supplemental information about a GenericWebPart control.

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

Valor da propriedade

String

Uma cadeia de caracteres que representa uma URL para mais informações sobre um GenericWebPart controle.A string that represents a URL to more information about a GenericWebPart control. O valor padrão é uma cadeia de caracteres vazia ("").The default value is an empty string ("").

Exemplos

O exemplo de código a seguir demonstra o uso declarativa e programático da TitleUrl propriedade.The following code example demonstrates declarative and programmatic use of the TitleUrl property. O código-fonte completo do exemplo é encontrado na seção de exemplo do GenericWebPart tópico Visão geral.The complete source code for the example is found in the Example section of the GenericWebPart overview topic.

A primeira parte do exemplo de código mostra como a TitleUrl propriedade é definida declarativamente em um controle de servidor dentro de um WebPartZone controle.The first part of the code example shows how the TitleUrl property is set declaratively on a server control within a WebPartZone control.

<asp:WebPartZone ID="WebPartZone1" runat="server">
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server"
      Title="My Calendar"
      Description="A calendar used as a GenericWebPart control."
      CatalogIconImageUrl="MyCatalogIcon.gif"
      TitleIconimageUrl ="MyTitleIcon.gif"
      TitleUrl="MyInfoUrl.htm" 
      Width="250"/>
  </ZoneTemplate>
</asp:WebPartZone>
<asp:WebPartZone ID="WebPartZone1" runat="server">
  <ZoneTemplate>
    <asp:Calendar ID="Calendar1" runat="server"
      Title="My Calendar"
      Description="A calendar used as a GenericWebPart control."
      CatalogIconImageUrl="MyCatalogIcon.gif"
      TitleIconimageUrl ="MyTitleIcon.gif"
      TitleUrl="MyInfoUrl.htm" 
      Width="250"/>
  </ZoneTemplate>
</asp:WebPartZone>

A segunda parte do exemplo de código demonstra como acessar a propriedade programaticamente para exibir seu valor em um rótulo.The second part of the code example demonstrates how to access the property programmatically to display its value in a label.

protected void Button1_Click(object sender, EventArgs e)
{

  Label2.Text =
    @"<h3>Calendar GenericWebPart Properties</h3>" +
    "<em>Title: </em>" + calendarPart.Title +
    "<br />" +
    "<em>CatalogIconImageUrl:  </em>" + calendarPart.CatalogIconImageUrl +
    "<br />" +
    "<em>TitleUrl: </em>" + calendarPart.TitleUrl +
    "<br />" +
    "<em>Decription: </em>" + calendarPart.Description +
    "<br />" +
    "<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
    "<br />" +
    "<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
    "<br />" +
    "<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
    "<br />" +
    "<em>GenericWebPart ID: </em>" + calendarPart.ID +
    "<br />" +
    "<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
    "<br />" +
    "<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;

  Label3.Text =
    @"<h3>BulletedList GenericWebPart Properties</h3>" +
    "<em>Title: </em>" + listPart.Title +
    "<br />" +
    "<em>CatalogIconImageUrl:  </em>" + listPart.CatalogIconImageUrl +
    "<br />" +
    "<em>TitleUrl: </em>" + listPart.TitleUrl +
    "<br />" +
    "<em>Decription: </em>" + listPart.Description +
    "<br />" +
    "<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
    "<br />" +
    "<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
    "<br />" +
    "<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
    "<br />" +
    "<em>GenericWebPart ID: </em>" + listPart.ID +
    "<br />" +
    "<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
    "<br />" +
    "<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
}
  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    Label2.Text = _
      "<h3>Calendar GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & calendarPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & calendarPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & calendarPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & calendarPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID

    Label3.Text = _
      "<h3>BulletedList GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & listPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & listPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & listPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & listPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & listPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
  End Sub

End Class

Comentários

Quando você atribui uma URL à TitleUrl propriedade, o título do controle se torna um link.When you assign a URL to the TitleUrl property, the title of the control becomes a link. Essa propriedade fornece uma maneira conveniente para os usuários finais acessarem informações adicionais sobre um controle.This property provides a convenient way for end users to access additional information about a control. As informações adicionais podem incluir dados de direitos autorais, dados de contato, detalhes sobre o criador do controle ou um resumo da finalidade de um controle.The additional information could include copyright data, contact data, details about the creator of the control, or a summary of the purpose of a control.

Essa propriedade substitui a propriedade base para que você possa acessar a propriedade no controle filho como se fosse um WebPart controle verdadeiro.This property overrides the base property so that you can access the property on the child control as if it were a true WebPart control.

Você pode definir valores para a propriedade em seu controle na marcação declarativa de uma página da Web, bem como programaticamente.You can set values for the property on your control in the declarative markup of a Web page, as well as programmatically. Para fornecer um valor padrão para a propriedade sempre que o controle for usado, você poderá implementar a IWebPart interface.To provide a default value for the property whenever the control is used, you can implement the IWebPart interface.

Aplica-se a