ConnectionPoint.DisplayName Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een tekenreeks op die fungeert als een beschrijvende weergavenaam die een verbindingspunt in de gebruikersinterface (UI) vertegenwoordigt.
public:
property System::String ^ DisplayName { System::String ^ get(); };
public string DisplayName { get; }
member this.DisplayName : string
Public ReadOnly Property DisplayName As String
Waarde van eigenschap
Een tekenreeks die een beschrijvende weergavenaam voor een ConnectionPoint object bevat.
Opmerkingen
Als u een verbinding met webonderdelen wilt maken, moeten de provider- en consumentenbesturingselementen voor de verbinding elk ten minste één verbindingspunt opgeven, een methode waarmee ze gegevens kunnen communiceren en delen. Om deze verbindingspuntmethoden te identificeren, geeft een ontwikkelaar een kenmerk op voor de geselecteerde methoden. In de provider wordt een ConnectionProvider kenmerk ingesteld op de geselecteerde callback-methode en in de consument wordt een ConnectionConsumer kenmerk ingesteld op de methode die een instantie ontvangt van een interface die gegevens van de provider bevat. Voor beide kenmerken is de parameter die altijd vereist is, ongeacht welke overbelasting wordt gedeclareerd om het kenmerk te maken, de displayName parameter. De ontwikkelaar moet een tekenreeks toewijzen die moet worden gebruikt als een beschrijvende weergavenaam voor het verbindingspunt en die tekenreeks wordt de waarde van de DisplayName eigenschap.
De DisplayName eigenschapswaarde wordt weergegeven in de gebruikersinterface van een webpagina wanneer gebruikers verbindingen maken. Wanneer het ConnectionsZone besturingselement bijvoorbeeld wordt toegevoegd aan de pagina, wordt er een gebruikersinterface gemaakt voor gebruikers om verbindingen tussen besturingselementen te maken. Nadat een gebruiker een pagina heeft overgeschakeld naar de weergavemodus Voor verbinding en op een verbindingswerkwoord op een WebPart besturingselement klikt, wordt de verbindingsinterface weergegeven. Elk besturingselement dat kan deelnemen aan een verbinding, wordt vermeld in de gebruikersinterface en naast elk besturingselement is een vervolgkeuzelijst die de beschrijvende namen van de beschikbare verbindingspunten weergeeft. Gebruikers moeten ten minste één verbindingspunt selecteren om een verbinding tot stand te brengen. De waarden die worden weergegeven in de lijst met verbindingspunten, worden opgehaald uit de DisplayName eigenschap. Als ontwikkelaars een aangepaste gebruikersinterface bouwen voor het maken van verbindingen, kunnen ze de DisplayName eigenschap op een vergelijkbare manier gebruiken om een beschrijvende naam op te geven die een verbindingspunt vertegenwoordigt.