ConnectionPoint.DisplayName 屬性

定義

取得字串,此字串在使用者介面 (UI) 做為表示連接點的易記顯示名稱。

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

屬性值

String

字串,包含 ConnectionPoint 物件的易記顯示名稱。

備註

若要建立Web 組件連線,連線的提供者和取用者控制項必須分別指定至少一個連接點,這個方法可讓它們進行通訊和共用資料。 為了識別這些連接點方法,開發人員會在選取的方法上指定屬性。 在提供者中, ConnectionProvider 屬性是在選取的回呼方法上設定,並在取用者中設定 ConnectionConsumer 屬性,這個方法會接收包含提供者資料的介面實例。 對於這兩個屬性,不論宣告要建立屬性的多載為何,一律需要一個參數是 displayName 參數。 開發人員必須指派字串,以做為連接點的 DisplayName 易記顯示名稱,而且該字串會成為 屬性的值。

當使用者 DisplayName 建立連線時,屬性值會顯示在網頁的 UI 中。 例如,當控制項新增至頁面時 ConnectionsZone ,它會建立 UI 供使用者建立控制項之間的連線。 當使用者將頁面切換為連線顯示模式,然後按一下控制項上的 WebPart 連接動詞之後,連接 UI 隨即出現。 每個可以參與連線的控制項都會列在 UI 中,而每個控制項旁的下拉式清單控制項會顯示其可用連接點的易記名稱。 使用者至少必須選取一個連接點,才能建立連線。 出現在連接點清單中的值是從 屬性取得 DisplayName 。 如果開發人員建置自訂 UI 來建立連線,他們可以使用 DisplayName 屬性,以類似的方式提供代表連接點的易記名稱。

適用於

另請參閱