ConnectionConsumerAttribute.DisplayName Property

Definition

Gets the friendly name of the consumer connection point.

C#
public virtual string DisplayName { get; }

Property Value

A string containing a friendly display name for the consumer connection point.

Examples

The following code example demonstrates using the DisplayName property, by showing how to declare the ConnectionConsumerAttribute metadata element on a callback method in a consumer control. Note that the simplest overload of the constructor is used; only the displayName parameter value is supplied. The value of the parameter will become the value of the DisplayName property. For the full code required to run the code example, see the ConnectionConsumerAttribute class overview.

C#
[ConnectionConsumer("Row")]
public void SetConnectionInterface(IWebPartRow provider) 
{
    _provider = provider;
}

Remarks

This property is the friendly name of a consumer connection point. Its value can be set declaratively, when you add the displayName parameter to a ConnectionConsumerAttribute metadata element on a callback method. It can also be set programmatically by a derived class, by using the protected DisplayNameValue property.

When you are searching through a connection point collection, you should use the ID property, because the ID property must be unique, but the DisplayName property need not be.

The DisplayName property of a consumer connection point is displayed to users when a ConnectionsZone control is on the page, the connection user interface (UI) is open, and the users are in a view where they are allowed to select connection points to establish a connection.

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

See also