TextBox.Render(HtmlTextWriter) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет визуализацию элемента управления TextBox в указанный объект HtmlTextWriter.
protected:
override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
override void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected override void Render (System.Web.UI.HtmlTextWriter writer);
protected internal override void Render (System.Web.UI.HtmlTextWriter writer);
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Overrides Sub Render (writer As HtmlTextWriter)
Protected Friend Overrides Sub Render (writer As HtmlTextWriter)
Параметры
- writer
- HtmlTextWriter
Объект HtmlTextWriter, извлекающий преобразованные выходные данные.
Примеры
В следующем примере кода показано, как переопределить Render метод в пользовательском серверном элементе управления, TextBox чтобы элемент управления всегда отображался вместе с изображением.
Важно!
В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Custom TextBox - Render - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom TextBox - Render - C# Example</h3>
<aspSample:CustomTextBoxRender
id="TextBox1"
runat="server">Hello World!
</aspSample:CustomTextBoxRender>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Custom TextBox - Render - VB.NET Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<h3>Custom TextBox - Render - VB.NET Example</h3>
<aspSample:CustomTextBoxRender id="TextBox1"
runat="server">Hello World!</aspSample:CustomTextBoxRender>
</form>
</body>
</html>
using System.Web;
using System.Security.Permissions;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public sealed class CustomTextBoxRender : System.Web.UI.WebControls.TextBox
{
protected override void Render(System.Web.UI.HtmlTextWriter writer)
{
// Create and render a new Image Web control.
System.Web.UI.WebControls.Image image = new System.Web.UI.WebControls.Image();
image.ID = "Image1";
image.ImageUrl = "image.jpg";
image.AlternateText = "Image for TextBox1.";
image.RenderControl(writer);
// Create a BR tag.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Br);
// Call the base class's Render method.
base.Render(writer);
}
}
}
Imports System.Web
Imports System.Security.Permissions
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class CustomTextBoxRender
Inherits System.Web.UI.WebControls.TextBox
Protected Overrides Sub Render(ByVal writer As System.Web.UI.HtmlTextWriter)
' Create and render a new Image Web control.
Dim image As New System.Web.UI.WebControls.Image
image.ID = "Image1"
image.ImageUrl = "image.jpg"
image.AlternateText = "Image for TextBox1."
image.RenderControl(writer)
' Create a BR tag.
writer.RenderBeginTag(System.Web.UI.HtmlTextWriterTag.Br)
' Call the base class's Render method.
MyBase.Render(writer)
End Sub
End Class
End Namespace
Комментарии
Метод Render отрисовывает начальный и конечный TextBox тег элемента управления в HtmlTextWriter объект для вывода на клиенте. Если свойству TextMode присвоено значение MultiLine, содержимое TextBox элемента управления отображается как элемент HTML <textarea>
.
Метод Render используется в основном разработчиками элементов управления, расширяющими функциональные TextBox возможности элемента управления.