WebPartDescription.Title Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft den Titeltext eines entsprechenden WebPart-Steuerelements ab.

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

public string Title { get; }

member this.Title : string

Public ReadOnly Property Title As String

Eigenschaftswert

String

Eine Zeichenfolge mit dem Titel des entsprechenden Steuerelements. Der Standardwert ist eine von .NET Framework bereitgestellte berechnete Zeichenfolge.

Beispiele

Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der Title -Eigenschaft veranschaulicht. Den vollständigen Code, der zum Ausführen dieses Codebeispiels erforderlich ist, finden Sie im Abschnitt Beispiel des WebPartDescription Themas Klassenübersicht.

Der folgende Code in der Button1_Click -Methode einer Webseite veranschaulicht, wie sie die Auflistung von WebPartDescription Objekten in einem Katalog mithilfe der GetAvailableWebPartDescriptions -Methode abrufen und dann die Details der einzelnen WebPart Steuerelemente im Katalog anzeigen, indem Sie die WebPartDescription -Objekte durchlaufen. Beachten Sie, dass der Title Eigenschaftswert im folgenden Code abgerufen wird.

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

Hinweise

Der Wert der Title -Eigenschaft entspricht direkt der WebPart.DisplayTitle -Eigenschaft. Unabhängig davon, über welche Eigenschaft das entsprechende WebPart Steuerelement verfügt DisplayTitle , wird das zum Wert der Title -Eigenschaft. Andernfalls ist der Titel ein berechneter Wert.

Die Title -Eigenschaft wird nur angewendet, wenn sich eine Seite im Kataloganzeigemodus befindet und ein WebPart Steuerelement in einem Katalog von Steuerelementen angezeigt wird. Der beliebige Titel, der einem WebPart Steuerelement zugewiesen ist, wird neben dem Steuerelement im Katalog angezeigt.

Weitere Informationen

• DisplayTitle
• ASP.NET Webparts-Steuerelemente