WebPartDescription.CatalogIconImageUrl Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine URL ab, die den Pfad zu einem Bild enthält, das als Symbol für ein WebPart-Steuerelement verwendet wird.

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

public string CatalogIconImageUrl { get; }

member this.CatalogIconImageUrl : string

Public ReadOnly Property CatalogIconImageUrl As String

Eigenschaftswert

String

Eine Zeichenfolge mit einer URL. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der CatalogIconImageUrl -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 CatalogIconImageUrl 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

Die CatalogIconImageUrl -Eigenschaft entspricht direkt der WebPart.CatalogIconImageUrl -Eigenschaft. Wenn diese Eigenschaft für ein WebPart Steuerelement festgelegt ist, weist die Eigenschaft im entsprechenden WebPartDescription Objekt auch einen Wert auf.

Die CatalogIconImageUrl -Eigenschaft gilt nur, wenn sich eine Seite im Kataloganzeigemodus befindet und ein WebPart Steuerelement in einem Katalog von Steuerelementen angezeigt wird. Wenn dem Steuerelement im Eigenschaftswert ein Symbol zugewiesen ist, wird das Symbol im Katalog neben dem Steuerelement angezeigt.

Gilt für:

Freigeben über