WebPartManager.BeginWebPartConnecting(WebPart) Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Запускает подключение двух элементов управления 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 -> unit
Public Overridable Sub BeginWebPartConnecting (webPart As WebPart)

Параметры

webPart
WebPart

Элемент управления, для которого создается подключение.

Исключения

ArgumentNullException

webPart имеет значение null.

InvalidOperationException

Текущий режим отображения на странице не равен ConnectDisplayMode.

ArgumentException

webPart закрыт.

-или-

webPart не является частью коллекции Controls.

-или-

webPart равен элементу управления SelectedWebPart.

Комментарии

Метод BeginWebPartConnecting существует для того, чтобы процесс формирования соединений между элементами управления можно было выполнять на разных этапах, предоставляя разработчикам больший контроль над процессом подключения. Метод выполняет набор начальных проверок, чтобы убедиться, что webPart находится в состоянии, в котором соединение может быть законно сформировано. Если webPart все проверки пройдены, он задается как выбранный в данный момент элемент управления (см. SelectedWebPart свойство ), и процесс подключения может продолжиться.

Примечания для тех, кто наследует этот метод

Разработчикам, которым необходимо расширить WebPartManager элемент управления, может потребоваться переопределить этот метод в производном классе. Один из подходов — вызвать базовый метод, а затем добавить дополнительную пользовательскую обработку; или может потребоваться полностью настроить процесс запуска соединения между элементами управления. Например, перед созданием подключения может потребоваться убедиться, что определенные данные доступны.

Применяется к

См. также раздел