WebPartManager.BeginWebPartConnecting(WebPart) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает подключение двух элементов управления WebPart друг к другу.
public:
virtual void BeginWebPartConnecting(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);public virtual void BeginWebPartConnecting (System.Web.UI.WebControls.WebParts.WebPart webPart);abstract member BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unitPublic Overridable Sub BeginWebPartConnecting (webPart As WebPart)Параметры
- webPart
- WebPart
Элемент управления, для которого создается подключение.
Исключения
webPart имеет значение null.
Текущий режим отображения на странице не равен ConnectDisplayMode.
webPart закрыт.
-или-
webPart не является частью коллекции Controls.
-или-
webPart равен элементу управления SelectedWebPart.
Комментарии
Метод BeginWebPartConnecting существует для того, чтобы процесс формирования соединений между элементами управления можно было выполнять на разных этапах, предоставляя разработчикам больший контроль над процессом подключения. Метод выполняет набор начальных проверок, чтобы убедиться, что webPart находится в состоянии, в котором соединение может быть законно сформировано. Если webPart все проверки пройдены, он задается как выбранный в данный момент элемент управления (см. SelectedWebPart свойство ), и процесс подключения может продолжиться.
Примечания для тех, кто наследует этот метод
Разработчикам, которым необходимо расширить WebPartManager элемент управления, может потребоваться переопределить этот метод в производном классе. Один из подходов — вызвать базовый метод, а затем добавить дополнительную пользовательскую обработку; или может потребоваться полностью настроить процесс запуска соединения между элементами управления. Например, перед созданием подключения может потребоваться убедиться, что определенные данные доступны.
