WebPartDescription.CatalogIconImageUrl 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得 URL，其中包含至用做 WebPart 控制項圖示影像的路徑。

public:
 property System::String ^ CatalogIconImageUrl { System::String ^ get(); };
public string CatalogIconImageUrl { get; }
member this.CatalogIconImageUrl : string
Public ReadOnly Property CatalogIconImageUrl As String

屬性值

String

包含 URL 的字串；預設為空字串 ("")。

範例

下列程式碼範例示範屬性的程式 CatalogIconImageUrl 設計用法。 如需執行此程式碼範例所需的完整程式碼，請參閱類別概觀主題的 WebPartDescription 範例一節。

網頁方法中的 Button1_Click 下列程式碼示範如何使用 方法來取得目錄中 GetAvailableWebPartDescriptions 物件的集合 WebPartDescription ，然後藉由迴圈 WebPartDescription 查看 物件，在目錄中顯示每個 WebPart 控制項的詳細資料。 請注意， CatalogIconImageUrl 屬性值會在下列程式碼中擷取。

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

備註

屬性 CatalogIconImageUrl 會直接對應至 WebPart.CatalogIconImageUrl 屬性。 如果在控制項上 WebPart 設定該屬性，則對應 WebPartDescription 物件中的 屬性也會有值。

只有在 CatalogIconImageUrl 頁面處於目錄顯示模式，且 WebPart 控制項顯示在控制項目錄中時，屬性才會套用。 如果控制項在屬性值中指派了圖示，則圖示會出現在控制項旁的目錄中。

適用於

另請參閱