HtmlTextArea.Name Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o nome de identificador exclusivo para o controle HtmlTextArea.
public:
virtual property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };public virtual string Name { get; set; }member this.Name : string with get, setPublic Overridable Property Name As StringValor da propriedade
Uma cadeia de caracteres que representa o valor da UniqueID propriedade.
Exemplos
O exemplo de código a seguir demonstra como usar a Name propriedade para selecionar um HtmlTextArea controle em uma página e definir sua Value propriedade.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" >
void Page_Load(Object sender, EventArgs e)
{
// Bind a data source to the Repeater control.
Repeater1.DataSource = CreateRepeaterSource();
Repeater1.DataBind();
}
void Item_Bound(Object sender, RepeaterItemEventArgs e)
{
// The ItemDataBound event is raised when data is bound to an
// item in the Repeater control. Items can include the Header,
// Footer, and so on. Use the following logic only if the item
// being bound is an Item or AlternatingItem.
if (e.Item.ItemType == ListItemType.Item ||
e.Item.ItemType == ListItemType.AlternatingItem)
{
// The runtime automatically generates a unique identifier
// for each control embedded in a list control, such as the
// Repeater control. The Name property of the HtmlTextArea
// control contains this unique identifier and is commonly used to
// identify a specific control.
// Retrieve the HtmlTextArea control from the RepeaterItem.
HtmlTextArea area = (HtmlTextArea)e.Item.FindControl("TextArea1");
// Insert a custom message for the fourth HtmlTextArea control by
// looking for a Name property that contains the number 3.
if (area.Name.Contains("3"))
{
area.Value = "Hello World";
}
}
}
DataView CreateRepeaterSource()
{
// Create a DataTable that contains sample data for the
// Repeater control.
DataTable dt = new DataTable();
DataRow dr;
dt.Columns.Add(new DataColumn("Category", typeof(String)));
// Populate the DataTable with sample values.
for (int i = 0; i < 5; i++)
{
dr = dt.NewRow();
dr[0] = "Category " + i.ToString();
dt.Rows.Add(dr);
}
// Create a DataView from the DataTable.
DataView dv = new DataView(dt);
return dv;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea Name Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea Name Example</h3>
Notice that Category 3 has custom text. <br />
<asp:Repeater id="Repeater1"
onitemdatabound="Item_Bound"
runat="server">
<ItemTemplate>
<h4><%# DataBinder.Eval(Container.DataItem, "Category") %></h4>
Enter text:
<br />
<textarea rows="2" cols="20" id="TextArea1"
runat="server"/>
<br /><br />
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" >
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Bind a data source to the Repeater control.
Repeater1.DataSource = CreateRepeaterSource()
Repeater1.DataBind()
End Sub
Sub Item_Bound(ByVal sender As Object, ByVal e As RepeaterItemEventArgs)
' The ItemDataBound event is raised when data is bound to an
' item in the Repeater control. Items can include the Header,
' Footer, and so on. Use the following logic only if the item
' being bound is an Item or AlternatingItem.
If (e.Item.ItemType = ListItemType.Item) Or _
(e.Item.ItemType = ListItemType.AlternatingItem) Then
' The runtime automatically generates a unique identifier
' for each control embedded in a list control, such as the
' Repeater control. The Name property of the HtmlTextArea
' control contains this unique identifier and is commonly used to
' identify a specific control.
' Retrieve the HtmlTextArea control from the RepeaterItem.
Dim area As HtmlTextArea = _
CType(e.Item.FindControl("TextArea1"), HtmlTextArea)
' Insert a custom message for the fourth HtmlTextArea control by
' looking for a Name property that contains the number 3.
If area.Name.Contains("3") Then
area.Value = "Hello World"
End If
End If
End Sub
Function CreateRepeaterSource() As DataView
' Create a DataTable that contains sample data for the
' Repeater control.
Dim dt As DataTable = New DataTable()
Dim dr As DataRow
dt.Columns.Add(New DataColumn("Category", GetType(String)))
' Populate the DataTable with sample values.
Dim i As Integer
For i = 0 To 4
dr = dt.NewRow()
dr(0) = "Category " & i.ToString()
dt.Rows.Add(dr)
Next i
' Create a DataView from the DataTable.
Dim dv As DataView = New DataView(dt)
Return dv
End Function
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea Name Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea Name Example</h3>
Notice that Category 3 has custom text. <br />
<asp:Repeater id="Repeater1"
onitemdatabound="Item_Bound"
runat="server">
<ItemTemplate>
<h4><%# DataBinder.Eval(Container.DataItem, "Category") %></h4>
Enter text:
<br />
<textarea rows="2" cols="20" id="TextArea1"
runat="server"/>
<br /><br />
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
Comentários
Use a Name propriedade para determinar o nome do identificador exclusivo para o HtmlTextArea controle. Nesta implementação da propriedade, o get acessador retorna o valor da Control.UniqueID propriedade. No entanto, o set acessador não atribui um valor a essa propriedade.
Observação
O set acessador não atribui um valor a essa propriedade porque a Name propriedade deve ter o mesmo valor que a Control.UniqueID propriedade para que o HtmlTextArea controle funcione corretamente.
Classes que herdam da HtmlTextArea classe podem substituir essa implementação, se necessário.