WebPartDescription.Title Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém o texto do título de um controle de WebPart correspondente.

public:
 property System::String ^ Title { System::String ^ get(); };

public string Title { get; }

member this.Title : string

Public ReadOnly Property Title As String

Valor da propriedade

String

Uma cadeia de caracteres que contém o título do controle correspondente. O valor padrão é uma cadeia de caracteres calculada fornecida pelo .NET Framework.

Exemplos

O exemplo de código a seguir demonstra o uso programático da Title propriedade . Para obter o código completo necessário para executar este exemplo de código, consulte a seção Exemplo do tópico de visão geral da WebPartDescription classe.

O código a Button1_Click seguir no método de uma página da Web demonstra como obter a coleção de WebPartDescription objetos em um catálogo usando o GetAvailableWebPartDescriptions método e, em seguida, exibir os detalhes de cada WebPart controle no catálogo fazendo loop pelos WebPartDescription objetos. Observe que o valor da Title propriedade é recuperado no código a seguir.

protected void Button1_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;
  
  WebPartDescriptionCollection descriptions = 
    DeclarativeCatalogPart1.GetAvailableWebPartDescriptions();

  foreach (WebPartDescription desc in descriptions)
  {
    Label1.Text += "ID: " + desc.ID + "<br />" +
      "Title: " + desc.Title + "<br />" +
      "Description: " + desc.Description + "<br />" +
      "ImageUrl: " + desc.CatalogIconImageUrl + "<br />" +
      "<hr />";
  }
}

Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As System.EventArgs)
  
  Label1.Text = String.Empty
      
  Dim descriptions As WebPartDescriptionCollection = _
   DeclarativeCatalogPart1.GetAvailableWebPartDescriptions()
          
  Dim desc As WebPartDescription
      
  For Each desc In descriptions
    Label1.Text += "ID: " & desc.ID & "<br />" & _
      "Title: " & desc.Title & "<br />" & _
      "Description: " & desc.Description & "<br />" & _
      "ImageUrl: " & desc.CatalogIconImageUrl & "<br />" & _
      "<hr />"
  Next
  
End Sub

Comentários

O valor da Title propriedade corresponde diretamente à WebPart.DisplayTitle propriedade . Qualquer que seja o controle correspondente WebPart para sua DisplayTitle propriedade, que se torna o valor da Title propriedade; caso contrário, o título é um valor calculado.

A Title propriedade só se aplica quando uma página está no modo de exibição de catálogo e um WebPart controle está sendo exibido em um catálogo de controles. Qualquer título atribuído a um WebPart controle aparece ao lado do controle no catálogo.

Aplica-se a

Compartilhar via