INamingContainer Schnittstelle

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Gibt ein Containersteuerelement an, das einen neuen ID-Namespace innerhalb der Steuerelementhierarchie eines Page-Objekts erstellt. Hierbei handelt es sich nur um eine Markierungsschnittstelle.

public interface class INamingContainer
public interface INamingContainer
type INamingContainer = interface
Public Interface INamingContainer
Abgeleitet

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefiniertes Serversteuerelement mit Vorlagen veranschaulicht, das die INamingContainer -Schnittstelle implementiert. Wenn dieses benutzerdefinierte Serversteuerelement in einer .aspx-Datei verwendet wird, stellt es einen eindeutigen Namespace für alle darin enthaltenen Serversteuerelemente bereit.

using System;
using System.Collections;
using System.Web;
using System.Web.UI;

namespace TemplateControlSamples {

    public class RepeaterItem : Control, INamingContainer {

        private int itemIndex;
        private object dataItem;

        public RepeaterItem(int itemIndex, object dataItem) {
            this.itemIndex = itemIndex;
            this.dataItem = dataItem;
        }

        public object DataItem {
            get {
                return dataItem;
            }
        }

        public int ItemIndex {
            get {
                return itemIndex;
            }
        }
    }
}

Imports System.Collections
Imports System.Web
Imports System.Web.UI

Namespace TemplateControlSamplesVB

    Public Class RepeaterItemVB : Inherits Control : Implements INamingContainer

        Private _ItemIndex As Integer
        Private _DataItem As Object

        Public Sub New(ItemIndex As Integer, DataItem As Object)
            MyBase.New()
            _ItemIndex = ItemIndex
            _DataItem = DataItem
        End Sub

        Public ReadOnly Property DataItem As Object
            Get
                return _DataItem
            End Get
        End Property

        Public ReadOnly Property ItemIndex As Integer
            Get
                return _ItemIndex
            End Get
        End Property

    End Class

End Namespace

Hinweise

Jedes Steuerelement, das diese Schnittstelle implementiert, erstellt einen neuen Namespace, in dem alle untergeordneten Steuerelement-ID-Attribute garantiert innerhalb einer gesamten Anwendung eindeutig sind. Der von dieser Schnittstelle bereitgestellte Marker ermöglicht eine eindeutige Benennung der dynamisch generierten Serversteuerungsinstanzen innerhalb der Webserversteuerelemente, die die Datenbindung unterstützen. Zu diesen Steuerelementen gehören die RepeaterSteuerelemente , DataGrid, DataListCheckBoxList, LoginViewChangePassword, Menu, SiteMapNodeItemund RadioButtonList .

Wenn Sie Steuerelemente mit Vorlagen entwickeln, sollten Sie diese Schnittstelle implementieren, um Namenskonflikte auf einer Seite zu vermeiden. Weitere Informationen finden Sie unter Übersicht über ASP.NET-Steuerelement-Designer.

Erweiterungsmethoden

GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.
GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.
SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.
SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.
TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.
EnableDynamicData(INamingContainer, Type)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement
EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

Gilt für:

Weitere Informationen