WebPartDescription.CatalogIconImageUrl プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
WebPart コントロールのアイコンとして使用されるイメージへのパスを含む URL を取得します。
public:
property System::String ^ CatalogIconImageUrl { System::String ^ get(); };
public string CatalogIconImageUrl { get; }
member this.CatalogIconImageUrl : string
Public ReadOnly Property CatalogIconImageUrl As String
プロパティ値
URL を含む文字列。既定値は空の文字列 ("") です。
例
次のコード例は、 CatalogIconImageUrl プロパティのプログラムによる使用を示しています。 このコード例を実行するために必要な完全なコードについては、「 WebPartDescription クラスの概要」トピックの「例」セクションを参照してください。
Web ページの 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 コントロールがコントロールのカタログに表示されている場合にのみ適用されます。 コントロールにプロパティ値にアイコンが割り当てられている場合、アイコンはコントロールの横のカタログに表示されます。