ConnectionPoint.DisplayName Propriété

Définition

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 : string
Public ReadOnly Property DisplayName As String

Valeur 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.

S’applique à

Voir aussi