WebPartDescription.ID プロパティ

.NET Framework クラス ライブラリ リファレンス

WebPartDescription.ID プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

対応する WebPart コントロールの ID を取得します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 ID As String

Visual Basic (使用法)

Dim instance As WebPartDescription
Dim value As String

value = instance.ID

C#

public string ID { get;
 }

C++

public:
property String^ ID {
    String^ get ();
}

J#

/** @property */
public String get_ID ()

JScript

public function get ID ()
 : String

プロパティ値
コントロールの ID を含む文字列。

解説

ID プロパティの値は null 参照 (Visual Basic では Nothing) にはできません。常に値を設定する必要があります。ID プロパティは、Control.ID プロパティに直接対応します。

ID プロパティは、ページがカタログ表示モードである場合のみ適用され、コントロールのカタログに WebPart コントロールが表示されます。

使用例

ID プロパティのプログラムでの使用方法を示すコード例を次に示します。このコード例の実行に必要なコード全体については、WebPartDescription クラスの概要のトピックで「例」を参照してください。

Web ページの Button1_Click メソッド内にある次のコードは、カタログ内のWebPartDescription オブジェクトのコレクションを GetAvailableWebPartDescriptions メソッドを使用して取得する方法と、カタログ内の各 WebPart コントロールの詳細を WebPartDescription オブジェクトをループして表示する方法を示します。ID プロパティ値は次のコードで取得されます。

Visual Basic

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

C#

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 />";
  }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartDescription クラス
WebPartDescription メンバ
System.Web.UI.WebControls.WebParts 名前空間
Control.ID
その他の技術情報
ASP.NET Web パーツ ページ