ConnectionPoint.DisplayName Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 : stringPublic ReadOnly Property DisplayName As StringEigenschaftswert
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.
