WebPartDescription 建構函式

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

初始化包含特定 WebPart 控制項資訊的新類別執行個體。

多載

WebPartDescription(WebPart)	有 WebPart 控制項執行個體可用時初始化新的類別執行個體。
WebPartDescription(String, String, String, String)	使用包含 WebPart 控制項描述資訊的數個字串初始化類別的新執行個體。

備註

建構函式的多 WebPartDescription 載每一個都會傳回 類別的新實例 WebPartDescription ，其中包含特定 WebPart 控制項的相關資訊。 多載之間的差異在於建立新實例的案例。 在某些情況下，當應用程式有控制項的 WebPart 可用實例時， WebPartDescription 會使用 建構函式。 當應用程式沒有控制項實例時，如同透過 控制項匯入 ImportCatalogPart 控制項描述檔案的情況， WebPartDescription 則會使用 建構函式。

WebPartDescription(WebPart)

有 WebPart 控制項執行個體可用時初始化新的類別執行個體。

public:
 WebPartDescription(System::Web::UI::WebControls::WebParts::WebPart ^ part);

public WebPartDescription (System.Web.UI.WebControls.WebParts.WebPart part);

new System.Web.UI.WebControls.WebParts.WebPartDescription : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartDescription

Public Sub New (part As WebPart)

參數

part

WebPart

WebPart 控制項，其資訊包含在 WebPartDescription 之中。

例外狀況

ArgumentException

part 的 ID 屬性為 null 或空字串 ("")。

備註

建 WebPartDescription 構函式是用來根據現有 WebPart 控制項建立新的 WebPartDescription 物件。 這個建構函式只會呼叫其他多載建 WebPartDescription(String, String, String, String) 構函式，從 參數的屬性 part 取得必要的參數值。

WebPartDescription(String, String, String, String)

使用包含 WebPart 控制項描述資訊的數個字串初始化類別的新執行個體。

public:
 WebPartDescription(System::String ^ id, System::String ^ title, System::String ^ description, System::String ^ imageUrl);

public WebPartDescription (string id, string title, string description, string imageUrl);

new System.Web.UI.WebControls.WebParts.WebPartDescription : string * string * string * string -> System.Web.UI.WebControls.WebParts.WebPartDescription

Public Sub New (id As String, title As String, description As String, imageUrl As String)

參數

id

String

要指派給 ID 的值。

title

String

要指派給 Title 的值。

description

String

要指派給 Description 的值。

imageUrl

String

要指派給 CatalogIconImageUrl 的值。

例外狀況

ArgumentNullException

id 或 title 為 null 或空字串 ("")。

備註

當控制項無法使用時，建 WebPartDescription 構函式會用來建立 類別的新實例 WebPartDescription 。 WebPart 例如，當控制項匯入 WebPart 控制項的描述檔時，就會發生這種情況 ImportCatalogPart 。 它會取得它直接從描述檔案建立 WebPartDescription 物件所需的資訊，而且 WebPart 實例不存在。