Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà Control.ID.
Assembly: System.Web (in System.Web.dll)
<BindableAttribute(False)> _ <BrowsableAttribute(False)> _ Public Overridable ReadOnly Property NamingContainer As Control Get
[BindableAttribute(false)] [BrowsableAttribute(false)] public virtual Control NamingContainer { get; }
[BindableAttribute(false)] [BrowsableAttribute(false)] public: virtual property Control^ NamingContainer { Control^ get (); }
[<BindableAttribute(false)>] [<BrowsableAttribute(false)>] abstract NamingContainer : Control [<BindableAttribute(false)>] [<BrowsableAttribute(false)>] override NamingContainer : Control
Ciascuna pagina di un'applicazione Web ASP.NET contiene una gerarchia di controlli. Questa gerarchia non dipende dal fatto che un controllo generi un'interfaccia utente visibile per l'utente. Il contenitore dei nomi relativo a un determinato controllo rappresenta il controllo padre nella gerarchia che implementa l'interfaccia INamingContainer. Un controllo server che implementa questa interfaccia crea uno spazio dei nomi univoco per i valori della proprietà ID dei controlli server figlio. È possibile utilizzare la proprietà NamingContainer del controllo figlio di un contenitore di denominazione per ottenere un riferimento al contenitore padre.
La creazione di uno spazio dei nomi univoco per i controlli server è particolarmente importante quando si associano controlli server Web a dati, ad esempio i controlli server Repeater e DataList. Quando più voci all'interno dell'origine dati creano più istanze di un controllo server, figlio di un controllo ripetuto, il contenitore dei nomi fa in modo che per ciascuna istanza dei controlli figlio siano presenti valori della proprietà UniqueID non in conflitto. Il contenitore dei nomi predefinito per una pagina rappresenta l'istanza della classe Page generata quando la pagina viene richiesta.
La proprietà ClientID contiene il valore di cui è stato eseguito il rendering come attributo id dell'elemento nel markup HTML. A seconda del valore che viene assegnato alla proprietà ClientIDMode, il valore generato per la proprietà ClientID potrebbe includere l'ID dell'oggetto NamingContainer. Se si imposta la proprietà ClientIDMode su Static, il valore ClientID non includerà l'ID dell'oggetto NamingContainer. Se si imposta la proprietà ClientIDMode su AutoID o Predictable, il valore ClientID includerà l'ID ottenuto dall'oggetto NamingContainer. Per ulteriori informazioni, vedere Identificazione dei controlli server Web ASP.NET.
Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà NamingContainer.
<%@ 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>
<% @ 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>
.NET Framework
Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.