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 элемент управления добавляется на страницу, он создает пользовательский интерфейс для создания подключений между элементами управления. После того как пользователь переключит страницу в режим отображения connect и щелкнет команду connect в элементе WebPart управления , появится пользовательский интерфейс подключения. Каждый элемент управления, который может участвовать в подключении, указан в пользовательском интерфейсе, а рядом с каждым элементом управления находится элемент управления раскрывающимся списком, в котором отображаются понятные имена доступных точек подключения. Чтобы установить подключение, пользователи должны выбрать хотя бы одну точку подключения. Значения, отображаемые в списке точек подключения, получаются из DisplayName свойства . Если разработчики создают пользовательский интерфейс для создания подключений, они могут использовать DisplayName свойство аналогичным образом для предоставления понятного имени, представляющего точку подключения.