ConnectionPoint.DisplayName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает строку, которая служит понятным отображаемым именем для представления точки подключения в пользовательском интерфейсе.
public:
property System::String ^ DisplayName { System::String ^ get(); };
public string DisplayName { get; }
member this.DisplayName : string
Public ReadOnly Property DisplayName As String
Значение свойства
Строка, содержащая понятное отображаемое имя объекта ConnectionPoint .
Комментарии
Чтобы создать подключение веб-частей, поставщик и элементы управления потребителем для подключения должны указывать по крайней мере одну точку подключения, метод, который позволяет им обмениваться данными и обмениваться данными. Чтобы определить эти методы точки подключения, разработчик задает атрибут для выбранных методов. В поставщике ConnectionProvider атрибут задается в выбранном методе обратного вызова, а в потребителе ConnectionConsumer атрибут устанавливается в методе, который получает экземпляр интерфейса, содержащего данные от поставщика. Для обоих этих атрибутов всегда требуется один параметр, независимо от того, какая перегрузка объявлена для создания атрибута, является параметром displayName . Разработчик должен назначить строку, которая будет использоваться в качестве понятного отображаемого имени для точки подключения, и эта строка становится значением DisplayName свойства.
Значение DisplayName свойства отображается в пользовательском интерфейсе веб-страницы при создании подключений пользователей. Например, когда ConnectionsZone элемент управления добавляется на страницу, он создает пользовательский интерфейс для пользователей для создания подключений между элементами управления. После переключения страницы в режим отображения подключения и нажатия команды подключения на WebPart элементе управления появится пользовательский интерфейс подключения. Каждый элемент управления, который может участвовать в подключении, отображается в пользовательском интерфейсе, а рядом с каждым элементом управления — раскрывающийся список, в котором отображаются понятные имена доступных точек подключения. Чтобы установить подключение, пользователи должны выбрать по крайней мере одну точку подключения. Значения, отображаемые в списке точек подключения, получены из DisplayName свойства. Если разработчики создают пользовательский интерфейс для создания подключений, они могут использовать DisplayName свойство таким же образом, чтобы предоставить понятное имя, представляющее точку подключения.