Freigeben über

ConnectionPoint.DisplayName Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft eine Zeichenfolge ab, die als benutzerfreundlicher Anzeigename dient und einen Verbindungspunkt in der Benutzeroberfläche darstellt.

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

Eigenschaftswert

String

Eine Zeichenfolge, die einen benutzerfreundlichen Anzeigenamen für ein ConnectionPoint-Objekt enthält.

Hinweise

Um eine Webparts-Verbindung zu erstellen, müssen die Anbieter- und Consumersteuerelemente für die Verbindung jeweils mindestens einen Verbindungspunkt angeben, eine Methode, mit der sie kommunizieren und Daten freigeben können. Um diese Verbindungspunktmethoden zu identifizieren, gibt ein Entwickler ein Attribut für die ausgewählten Methoden an. Im Anbieter wird ein ConnectionProvider Attribut für die ausgewählte Rückrufmethode festgelegt, und im Consumer wird ein ConnectionConsumer Attribut für die Methode festgelegt, die eine Instanz einer Schnittstelle empfängt, die Daten vom Anbieter enthält. Für beide Attribute ist displayName der Parameter, der immer erforderlich ist, unabhängig davon, welche Überladung zum Erstellen des Attributs deklariert wird. Der Entwickler muss eine Zeichenfolge zuweisen, die als Anzeigename für den Verbindungspunkt verwendet werden soll, und diese Zeichenfolge wird zum Wert der DisplayName Eigenschaft.

Der DisplayName Eigenschaftswert wird auf der Benutzeroberfläche einer Webseite angezeigt, wenn Benutzer Verbindungen erstellen. Wenn das ConnectionsZone Steuerelement beispielsweise der Seite hinzugefügt wird, wird eine Benutzeroberfläche erstellt, auf der Benutzer Verbindungen zwischen Steuerelementen erstellen können. Nachdem ein Benutzer eine Seite in den Verbindungsanzeigemodus wechselt und auf ein Verbindungsverb in einem WebPart Steuerelement klickt, wird die Verbindungsoberfläche angezeigt. Jedes Steuerelement, das an einer Verbindung teilnehmen kann, wird auf der Benutzeroberfläche aufgeführt, und neben jedem Steuerelement befindet sich ein Dropdown-Listensteuerelement, das die Anzeigenamen der verfügbaren Verbindungspunkte anzeigt. Benutzer müssen mindestens einen Verbindungspunkt auswählen, um eine Verbindung herzustellen. Die Werte, die in der Liste der Verbindungspunkte angezeigt werden, werden aus der DisplayName -Eigenschaft abgerufen. Wenn Entwickler eine benutzerdefinierte Benutzeroberfläche zum Erstellen von Verbindungen erstellen, können sie die DisplayName -Eigenschaft auf ähnliche Weise verwenden, um einen Anzeigenamen anzugeben, der einen Verbindungspunkt darstellt.

Gilt für:

Weitere Informationen