ConnectionPoint.DisplayName Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une chaîne qui sert de nom complet convivial pour représenter un point de connexion dans l'interface utilisateur.
public:
property System::String ^ DisplayName { System::String ^ get(); };public string DisplayName { get; }member this.DisplayName : stringPublic ReadOnly Property DisplayName As StringValeur de propriété
Chaîne qui contient un nom complet convivial pour un objet ConnectionPoint.
Remarques
Pour créer une connexion de composants WebPart, les contrôles fournisseur et consommateur de la connexion doivent chacun spécifier au moins un point de connexion, une méthode qui leur permet de communiquer et de partager des données. Pour identifier ces méthodes de point de connexion, un développeur spécifie un attribut sur les méthodes sélectionnées. Dans le fournisseur, un ConnectionProvider attribut est défini sur la méthode de rappel sélectionnée, et dans le consommateur, un ConnectionConsumer attribut est défini sur la méthode qui reçoit une instance d’une interface qui contient des données du fournisseur. Pour ces deux attributs, le seul paramètre qui est toujours requis, quelle que soit la surcharge déclarée pour créer l’attribut, est le displayName paramètre . Le développeur doit affecter une chaîne à utiliser comme nom d’affichage convivial pour le point de connexion, et cette chaîne devient la valeur de la DisplayName propriété .
La DisplayName valeur de la propriété s’affiche dans l’interface utilisateur d’une page Web lorsque les utilisateurs créent des connexions. Par exemple, lorsque le ConnectionsZone contrôle est ajouté à la page, il crée une interface utilisateur permettant aux utilisateurs de créer des connexions entre les contrôles. Une fois qu’un utilisateur bascule une page en mode d’affichage de connexion et clique sur un verbe de connexion sur un WebPart contrôle, l’interface utilisateur de connexion s’affiche. Chaque contrôle pouvant participer à une connexion est répertorié dans l’interface utilisateur, et en regard de chaque contrôle se trouve un contrôle de liste déroulante qui affiche les noms conviviaux de ses points de connexion disponibles. Les utilisateurs doivent sélectionner au moins un point de connexion pour établir une connexion. Les valeurs qui apparaissent dans la liste des points de connexion sont obtenues à partir de la DisplayName propriété . Si les développeurs créent une interface utilisateur personnalisée pour créer des connexions, ils peuvent utiliser la DisplayName propriété de la même manière pour fournir un nom convivial qui représente un point de connexion.
