WebControlAdapter.RenderContents(HtmlTextWriter) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает для веб-элемента управления, к которому присоединен соответствующий адаптер, особую внутреннюю разметку, характерную для целевого объекта.
protected:
virtual void RenderContents(System::Web::UI::HtmlTextWriter ^ writer);protected virtual void RenderContents (System.Web.UI.HtmlTextWriter writer);abstract member RenderContents : System.Web.UI.HtmlTextWriter -> unit
override this.RenderContents : System.Web.UI.HtmlTextWriter -> unitProtected Overridable Sub RenderContents (writer As HtmlTextWriter)Параметры
- writer
- HtmlTextWriter
Объект HtmlTextWriter, содержащий методы отрисовки целевого вывода.
Комментарии
RenderContentsМетод создает внутреннюю разметку между начальным и конечным тегами элемента управления. Как правило, разметка создается методом Render , который вызывает методы в следующем порядке:
Переопределите RenderContents , чтобы создать внутреннюю разметку для конкретного целевого объекта для отправки в браузер клиента.
RenderContentsБазовый метод вызывает WebControl.RenderContents . WebControl.RenderContentsБазовый метод вызывает Control.Render , который, в свою очередь, вызывает Control.RenderChildren . Таким способом, переопределения класса RenderContents должны вызывать RenderContents базовый метод только в том случае, если его обработка выполняется в дополнение к, а не к Control.Render .
Примечания для тех, кто наследует этот метод
Для составного элемента управления необходимо убедиться, что дочерние элементы управления подготавливаются к просмотру. Если переопределить RenderContents(HtmlTextWriter) метод и не вызвать его базовый метод, можно вызвать визуализацию дочерних элементов управления, вызвав метод RenderChildren(HtmlTextWriter) , если он не переопределен, вызывает RenderChildren(HtmlTextWriter) из RenderContents(HtmlTextWriter) переопределения.