Control.NamingContainer Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété.
public:
virtual property System::Web::UI::Control ^ NamingContainer { System::Web::UI::Control ^ get(); };[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.Control NamingContainer { get; }[System.ComponentModel.Browsable(false)]
[System.ComponentModel.Bindable(false)]
public virtual System.Web.UI.Control NamingContainer { get; }[<System.ComponentModel.Browsable(false)>]
member this.NamingContainer : System.Web.UI.Control[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.Bindable(false)>]
member this.NamingContainer : System.Web.UI.ControlPublic Overridable ReadOnly Property NamingContainer As ControlValeur de propriété
Conteneur d’affectation de noms du contrôle serveur.
- Attributs
Exemples
L’exemple suivant illustre l’utilisation de la NamingContainer propriété.
<% @ Import Namespace = "System.Data" %>
<!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>
Control NamingContainer Example
</title>
<script language="C#" runat="server">
// Build the DataSource.
ICollection CreateDataSource()
{
DataTable myDataTable = new DataTable();
DataRow myDataRow;
myDataTable.Columns.Add(new DataColumn("EmployeeName", typeof(string)));
for (int i = 0; i < 10; i++)
{
myDataRow = myDataTable.NewRow();
myDataRow[0] = "somename" + i.ToString();
myDataTable.Rows.Add(myDataRow);
}
DataView myDataView = new DataView(myDataTable);
return myDataView;
}
void Page_Load(Object sender, EventArgs e)
{
if (!IsPostBack)
{
// Bind 'DataView' to the DataSource.
myDataList.DataSource = CreateDataSource();
myDataList.DataBind();
}
// Attach EventHandler for SelectedIndexChanged event.
myDataList.SelectedIndexChanged += new EventHandler(selectedItemChanged);
}
// Handler function for 'SelectedIndexChanged' event.
void selectedItemChanged(Object sender,EventArgs e)
{
DataListItem myCurrentItem = myDataList.SelectedItem;
Control myNamingContainer = myCurrentItem.Controls[0].NamingContainer;
// Display the NamingContainer.
myLabel1.Text = "The NamingContainer is : " + myNamingContainer.UniqueID;
// Display the UniqueID.
myLabel2.Text = "The UniqueID is : " + ((Control)(myCurrentItem.Controls[0])).UniqueID;
}
</script>
</head>
<body>
<form runat="server" id="Form1">
<h3>
Control NamingContainer Example
</h3>
<h4>
Click an item to view it's Naming Container and UniqueID
</h4>
<asp:Label ID="myLabel1" Runat="server"></asp:Label>
<br />
<asp:Label ID="myLabel2" Runat="server"></asp:Label>
<br />
<asp:DataList id="myDataList" runat="server" BorderColor="black">
<HeaderStyle BackColor="#aaaadd"></HeaderStyle>
<SelectedItemStyle BackColor="lightgreen"></SelectedItemStyle>
<HeaderTemplate>
EmployeeName
</HeaderTemplate>
<ItemTemplate>
<asp:LinkButton id="button1" Text='<%# DataBinder.Eval(Container.DataItem, "EmployeeName") %>' CommandName="select" runat="server" />
</ItemTemplate>
</asp:DataList>
</form>
</body>
</html>
<%@ Import Namespace = "System.Data" %>
<!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>
Control NamingContainer Example
</title>
<script language="VB" runat="server">
' Build the DataSource.
Function CreateDataSource() As ICollection
Dim myDataTable As New DataTable()
Dim myDataRow As DataRow
myDataTable.Columns.Add(New DataColumn("EmployeeName", GetType(String)))
Dim i As Integer
For i = 0 To 9
myDataRow = myDataTable.NewRow()
myDataRow(0) = "somename" + i.ToString()
myDataTable.Rows.Add(myDataRow)
Next i
Dim myDataView As New DataView(myDataTable)
Return myDataView
End Function
Sub Page_Load(sender As Object, e As EventArgs)
If Not IsPostBack Then
' Bind 'DataView' to the DataSource.
myDataList.DataSource = CreateDataSource()
myDataList.DataBind()
End If
' Attach EventHandler for SelectedIndexChanged event.
AddHandler myDataList.SelectedIndexChanged, AddressOf selectedItemChanged
End Sub
' Handler function for 'SelectedIndexChanged' event.
Sub selectedItemChanged(sender As Object, e As EventArgs)
Dim myCurrentItem As DataListItem = myDataList.SelectedItem
Dim myNamingContainer As Control = myCurrentItem.Controls(0).NamingContainer
' Display the NamingContainer.
myLabel1.Text = "The NamingContainer is : " + myNamingContainer.UniqueID
' Display the UniqueID.
myLabel2.Text = "The UniqueID is : " + CType(myCurrentItem.Controls(0), Control).UniqueID
End Sub
</script>
</head>
<body>
<form runat="server" id="Form1">
<h3>
Control NamingContainer Example
</h3>
<h4>
Click an item to view it's Naming Container and UniqueID
</h4>
<asp:Label ID="myLabel1" Runat="server"></asp:Label>
<br />
<asp:Label ID="myLabel2" Runat="server"></asp:Label>
<br />
<asp:DataList id="myDataList" runat="server" BorderColor="black">
<HeaderStyle BackColor="#aaaadd"></HeaderStyle>
<SelectedItemStyle BackColor="lightgreen"></SelectedItemStyle>
<HeaderTemplate>
EmployeeName
</HeaderTemplate>
<ItemTemplate>
<asp:LinkButton id="button1" Text='<%# DataBinder.Eval(Container.DataItem, "EmployeeName") %>' CommandName="select" runat="server" />
</ItemTemplate>
</asp:DataList>
</form>
</body>
</html>
Remarques
Chaque page d’une application web ASP.NET contient une hiérarchie de contrôles. Cette hiérarchie ne dépend pas du fait qu’un contrôle génère une interface utilisateur visible pour l’utilisateur. Le conteneur d’affectation de noms pour un contrôle donné est le contrôle parent ci-dessus dans la hiérarchie qui implémente l’interface INamingContainer . Un contrôle serveur qui implémente cette interface crée un espace de noms unique pour les ID valeurs de propriété de ses contrôles serveur enfants. Vous pouvez utiliser la NamingContainer propriété d’un contrôle enfant d’un conteneur d’affectation de noms pour obtenir une référence à son conteneur parent.
La création d’un espace de noms unique pour les contrôles serveur est particulièrement importante lorsque vous liez des contrôles de serveur Web à des données, comme les contrôles serveur et DataList les Repeater contrôles serveur. Lorsque plusieurs entrées dans la source de données créent plusieurs instances d’un contrôle serveur enfant du contrôle répétitif, le conteneur d’affectation de noms garantit que chaque instance de ces contrôles enfants a UniqueID des valeurs de propriété qui ne sont pas en conflit. Le conteneur d’affectation de noms par défaut pour une page est l’instance de la Page classe générée lorsque cette page est demandée.
La ClientID propriété contient la valeur qui est rendue en tant qu’attribut de id l’élément dans le balisage HTML. Selon la valeur que vous affectez à la ClientIDMode propriété, la valeur générée pour la ClientID propriété peut inclure l’ID de l’objet NamingContainer . Lorsque vous définissez ClientIDModeStaticsur , la ClientID valeur n’inclut pas l’ID de l’objet NamingContainer . Lorsque vous définissez ClientIDMode sur l’une AutoID ou l’autre Predictablevaleur, la ClientID valeur inclut l’ID de l’objet NamingContainer . Pour plus d’informations, consultez ASP.NET Identification du contrôle de serveur web.
