WebPartConnectionsEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для событий WebPartsConnected и WebPartsDisconnected элемента управления WebPartManager.
public ref class WebPartConnectionsEventArgs : EventArgs
public class WebPartConnectionsEventArgs : EventArgs
type WebPartConnectionsEventArgs = class
inherit EventArgs
Public Class WebPartConnectionsEventArgs
Inherits EventArgs
- Наследование
Комментарии
Используя возможности набора элементов управления веб-частей, можно создать соединение между двумя WebPart или другими серверными элементами управления, при этом один элемент управления выступает в качестве поставщика, а другой — в качестве потребителя данных. Для формирования соединения два элемента управления должны находиться в зоне, наследуемой от WebPartZoneBase класса (например WebPartZone , элемента управления), и должны быть правильно спроектированы для совместного использования данных через общий интерфейс. Дополнительные сведения о подключениях веб-частей см. в разделах и Общие сведения WebPartConnection о подключениях веб-частей.
Класс WebPartConnectionsEventArgs передает данные событий методам, которые используют WebPartConnectionsEventHandler делегат для обработки событий. Существует два таких метода, связанных с подключением, которые вызывают события и используют WebPartConnectionsEventArgs класс для предоставления данных о событиях. Оба элемента управления являются членами WebPartManager элемента управления . Метод OnWebPartsConnected вызывает событие после успешного WebPartsConnected подключения двух серверных элементов управления, а OnWebPartsDisconnected метод вызывает WebPartsDisconnected событие после отключения двух серверных элементов управления.
Разработчики могут создавать пользовательские методы обработчика событий для WebPartsConnected событий и WebPartsDisconnected , а в этих методах они могут использовать WebPartConnectionsEventArgs класс для доступа к сведениям о соединении. Например, разработчик может объявить OnWebPartsConnected
атрибут в элементе <asp:webpartmanager>
и присвоить ему имя пользовательского метода, который будет обрабатывать событие. В пользовательском методе обработчика разработчики могут получить доступ к сведениям о соединении с помощью WebPartConnectionsEventArgs объекта , передаваемого в метод в качестве параметра.
Класс WebPartConnectionsEventArgs имеет две перегрузки конструктора. Конструктор WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) используется по умолчанию; он инициализирует значения свойств для класса . Конструктор WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) вызывает конструктор без параметров, а затем инициализирует Connection свойство .
Класс WebPartConnectionsEventArgs имеет несколько свойств, все из которых относятся к основным аспектам подключения веб-частей. Свойство Connection ссылается на связанный WebPartConnection объект, представляющий все соединение. Свойство Provider ссылается на или другой серверный WebPart элемент управления, выступающий в качестве поставщика в соединении, а Consumer свойство ссылается на серверный WebPart элемент управления или , выступающий в качестве потребителя. Свойство ProviderConnectionPoint ссылается на объект соединения ProviderConnectionPoint , а ConsumerConnectionPoint свойство ссылается на ConsumerConnectionPoint объект .
Конструкторы
WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) |
Инициализирует новый экземпляр класса WebPartConnectionsEventArgs, не требуя объект WebPartConnection. |
WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) |
Инициализирует новый экземпляр класса, используя указанный объект WebPartConnection. |
Свойства
Connection |
Получает объект WebPartConnection текущей связи. |
Consumer |
Получает элемент управления WebPart, играющий в связи роль объекта-получателя. |
ConsumerConnectionPoint |
Получает объект ConsumerConnectionPoint текущей связи. |
Provider |
Получает элемент управления WebPart, играющий в связи роль поставщика. |
ProviderConnectionPoint |
Получает объект ProviderConnectionPoint текущей связи. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |