Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Control-Klasse

 

Veröffentlicht: Oktober 2016

Definiert die Eigenschaften, Methoden und Ereignisse, die von allen ASP.NET-Serversteuerelementen gemeinsam verwendet werden.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.DynamicData.DynamicControl
    System.Web.DynamicData.DynamicDataManager
    System.Web.DynamicData.DynamicEntity
    System.Web.DynamicData.DynamicFilter
    System.Web.DynamicData.EntityTemplate
    System.Web.DynamicData.QueryableFilterRepeater
    System.Web.UI.BasePartialCachingControl
    System.Web.UI.DataBoundLiteralControl
    System.Web.UI.DataSourceControl
    System.Web.UI.DesignerDataBoundLiteralControl
    System.Web.UI.ExtenderControl
    System.Web.UI.HierarchicalDataSourceControl
    System.Web.UI.HtmlControls.HtmlControl
    System.Web.UI.LiteralControl
    System.Web.UI.MobileControls.DeviceSpecific
    System.Web.UI.MobileControls.MobileControl
    System.Web.UI.ScriptManager
    System.Web.UI.ScriptManagerProxy
    System.Web.UI.TemplateControl
    System.Web.UI.Timer
    System.Web.UI.UpdatePanel
    System.Web.UI.UpdateProgress
    System.Web.UI.WebControls.Content
    System.Web.UI.WebControls.ContentPlaceHolder
    System.Web.UI.WebControls.DataPager
    System.Web.UI.WebControls.DataPagerFieldItem
    System.Web.UI.WebControls.HiddenField
    System.Web.UI.WebControls.ListViewItem
    System.Web.UI.WebControls.Literal
    System.Web.UI.WebControls.LoginView
    System.Web.UI.WebControls.MenuItemTemplateContainer
    System.Web.UI.WebControls.MultiView
    System.Web.UI.WebControls.PlaceHolder
    System.Web.UI.WebControls.QueryExtender
    System.Web.UI.WebControls.Repeater
    System.Web.UI.WebControls.RepeaterItem
    System.Web.UI.WebControls.Substitution
    System.Web.UI.WebControls.View
    System.Web.UI.WebControls.WebControl
    System.Web.UI.WebControls.WebParts.ProxyWebPartManager
    System.Web.UI.WebControls.WebParts.WebPartManager
    System.Web.UI.WebControls.Xml

[BindableAttribute(true)]
[ThemeableAttribute(false)]
public class Control : IComponent, IDisposable, IParserAccessor, 
	IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, 
	IControlDesignerAccessor, IExpressionsAccessor

NameBeschreibung
System_CAPS_pubmethodControl()

Initialisiert eine neue Instanz der Control-Klasse.

NameBeschreibung
System_CAPS_protpropertyAdapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Ruft ab oder legt das virtuelle Verzeichnis der Anwendung relativen des der Page oder UserControl -Objekt, das dieses Steuerelement enthält.

System_CAPS_pubpropertyBindingContainer

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Steuerelement, das diesem Steuerelement Datenbindung enthält.

System_CAPS_protpropertyChildControlsCreated

Ruft einen Wert, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

System_CAPS_pubpropertyClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.

System_CAPS_pubpropertyClientIDMode

Ruft ab oder legt den Algorithmus, der zum Generieren des Werts verwendet wird die ClientID Eigenschaft.

System_CAPS_protpropertyClientIDSeparator

Ruft einen Zeichenwert, der verwendete Trennzeichen darstellt ab der ClientID Eigenschaft.

System_CAPS_protpropertyContext

Ruft die HttpContext Objekt, das mit dem Steuerelement für die aktuelle Webanfrage zugeordnet.

System_CAPS_pubpropertyControls

Ruft ein ControlCollection -Objekt, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.

System_CAPS_pubpropertyDataItemContainer

Ruft einen Verweis auf den Benennungscontainer, wenn der Benennungscontainer implementiert IDataItemContainer.

System_CAPS_pubpropertyDataKeysContainer

Ruft einen Verweis auf den Benennungscontainer, wenn der Benennungscontainer implementiert IDataKeysControl.

System_CAPS_protpropertyDesignMode

Ruft einen Wert, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

System_CAPS_pubpropertyEnableTheming

Ruft ab oder legt einen Wert, der angibt, ob für dieses Steuerelement Designs gelten.

System_CAPS_pubpropertyEnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

System_CAPS_protpropertyEvents

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

System_CAPS_protpropertyHasChildViewState

Ruft einen Wert, der angibt, ob die untergeordneten Steuerelemente des aktuellen Steuerelements gespeicherten Ansichtszustand Einstellungen verfügen.

System_CAPS_pubpropertyID

Ruft ab oder legt den programmgesteuerten Bezeichner für das Webserversteuerelement zugewiesen.

System_CAPS_protpropertyIdSeparator

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft das Zeichen zum Trennen der Steuerelement-IDs verwendet.

System_CAPS_protpropertyIsChildControlStateCleared

Ruft einen Wert, der angibt, ob dieses Steuerelement enthaltenen Steuerelemente Steuerelementzustand verfügen.

System_CAPS_protpropertyIsTrackingViewState

Ruft einen Wert, der angibt, ob das Serversteuerelement Änderungen an seinem Ansichtszustand gespeichert wird.

System_CAPS_protpropertyIsViewStateEnabled

Ruft einen Wert, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

System_CAPS_protpropertyLoadViewStateByID

Ruft einen Wert, der angibt, ob das Steuerelement seinen Ansichtszustand über laden ID anstelle Index.

System_CAPS_pubpropertyNamingContainer

Ruft ein Verweis auf das Serversteuerelement Benennungscontainers, erstellt einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben Control.ID Eigenschaftswert.

System_CAPS_pubpropertyPage

Ruft einen Verweis auf die Page -Instanz, die das Steuerelement enthält.

System_CAPS_pubpropertyParent

Ruft einen Verweis auf die übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.

System_CAPS_pubpropertyRenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der das gerenderte HTML kompatibel ist.

System_CAPS_pubpropertySite

Ruft Informationen über den Container, der das aktuelle Steuerelement beim Rendern auf einer Entwurfsoberfläche hostet.

System_CAPS_pubpropertySkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.

System_CAPS_pubpropertyTemplateControl

Ruft ab oder legt einen Verweis auf die Vorlage, die dieses Steuerelement enthält.

System_CAPS_pubpropertyTemplateSourceDirectory

Ruft das virtuelle Verzeichnis von der Page oder UserControl die das aktuelle Steuerelement enthält.

System_CAPS_pubpropertyUniqueID

Ruft den eindeutigen, hierarchisch qualifizierten Bezeichner für das Steuerelement ab.

System_CAPS_pubpropertyValidateRequestMode

Ruft ab oder legt einen Wert, der angibt, ob der Clienteingaben vom Browser auf potenziell gefährliche Werte überprüft.

System_CAPS_protpropertyViewState

Ruft ein Wörterbuch von Statusinformationen, die zum Speichern und Wiederherstellen den Ansichtszustand eines Serversteuerelements in mehreren Anforderungen der gleichen Seite ermöglicht.

System_CAPS_protpropertyViewStateIgnoresCase

Ruft einen Wert, der angibt, ob die StateBag Objekt wird Groß-/Kleinschreibung.

System_CAPS_pubpropertyViewStateMode

Ruft ab oder legt den Modus Ansichtszustand des Steuerelements fest.

System_CAPS_pubpropertyVisible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.

NameBeschreibung
System_CAPS_protmethodAddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement hinzugefügt wird die Controls Auflistung von der Control Objekt.

System_CAPS_protmethodAddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Wendet die Stileigenschaften, die im Stylesheet Seite auf das Steuerelement definiert.

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Beginnt die Entwurfszeit-Verfolgung des Renderings von Daten.

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Sammelt Informationen über das Steuerelement und übermittelt sie an die Trace -Eigenschaft angezeigt, wenn die Überwachung für die Seite aktiviert ist.

System_CAPS_protmethodClearCachedClientID()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Legt die zwischengespeicherte ClientID Wert null.

System_CAPS_protmethodClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.

System_CAPS_protmethodClearChildState()

Löscht den Ansichtszustand und den Steuerelementzustand Informationen für alle des Serversteuerelements untergeordneten Steuerelemente.

System_CAPS_protmethodClearChildViewState()

Löscht die Informationen zum Ansichtszustand für alle Serversteuerelemente untergeordneten Steuerelemente.

System_CAPS_protmethodClearEffectiveClientIDMode()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Legt die ClientIDMode -Eigenschaft der aktuellen Steuerelementinstanz und alle untergeordneten Steuerelemente entsprechend Inherit.

System_CAPS_protmethodCreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.

System_CAPS_protmethodCreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.

System_CAPS_pubmethodDataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

System_CAPS_protmethodDataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option zum Auslösen der DataBinding Ereignis.

System_CAPS_protmethodDataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

System_CAPS_pubmethodDispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor sie aus dem Speicher freigegeben wird.

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Zur Entwurfszeit die Verfolgung von Renderingdaten wird beendet.

System_CAPS_protmethodEnsureChildControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, erstellt er auf die untergeordneten Steuerelemente.

System_CAPS_protmethodEnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodFindControl(String)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id Parameter.

System_CAPS_protmethodFindControl(String, Int32)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und eine ganze Zahl, die gemäß der pathOffset -Parameter, der die Suche unterstützt. Sie sollten diese Version von nicht überschreiben die FindControl Methode.

System_CAPS_pubmethodFocus()

Legt den Eingabefokus auf ein Steuerelement.

System_CAPS_protmethodGetDesignModeState()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Ruft die Entwurfszeitdaten für ein Steuerelement ab.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetRouteUrl(Object)

Ruft die URL, die einen Satz von Routenparametern entspricht.

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Ruft die URL, die einen Satz von Routenparametern entspricht.

System_CAPS_pubmethodGetRouteUrl(String, Object)

Ruft die URL, die einen Satz von Routenparametern und einem Routennamen entspricht.

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Ruft die URL, die einen Satz von Routenparametern und einem Routennamen entspricht.

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Gibt den Präfixen Teil der UniqueID -Eigenschaft des angegebenen Steuerelements.

System_CAPS_pubmethodHasControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

System_CAPS_protmethodHasEvents()

Gibt einen Wert, der angibt, ob Ereignisse für das Steuerelement oder einem beliebigen untergeordneten Steuerelement registriert werden.

System_CAPS_protmethodIsLiteralContent()

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Bestimmt, ob das Serversteuerelement nur literalen Inhalt enthält.

System_CAPS_protmethodLoadControlState(Object)

Steuerelementzustand Informationen aus einer früheren Seitenanforderung, die von gespeichert wurde wiederhergestellt die SaveControlState Methode.

System_CAPS_protmethodLoadViewState(Object)

Stellt Ansichtszustandsinformationen aus einer früheren Seitenanforderung, die von gespeichert wurde die SaveViewState Methode.

System_CAPS_protmethodMapPathSecure(String)

Ruft den physischen Pfad, dem ein virtueller Pfad, einen absoluten oder relativen zugeordnet ist.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.

System_CAPS_protmethodOnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

System_CAPS_protmethodOnInit(EventArgs)

Löst das Init-Ereignis aus.

System_CAPS_protmethodOnLoad(EventArgs)

Löst das Load-Ereignis aus.

System_CAPS_protmethodOnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.

System_CAPS_protmethodOnUnload(EventArgs)

Löst das Unload-Ereignis aus.

System_CAPS_protmethodOpenFile(String)

Ruft eine Stream verwendet, um eine Datei zu lesen.

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Weist eine beliebige Quelle des Ereignisses und den zugehörigen übergeordneten Element des Steuerelements.

System_CAPS_protmethodRemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus entfernt, wird die Controls Auflistung von der Control Objekt.

System_CAPS_protmethodRender(HtmlTextWriter)

Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gibt den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter -Objekt, das den zu rendernden Inhalt auf dem Client schreibt.

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter -Objekt und Ablaufverfolgungsinformationen über das Steuerelement speichert, wenn die Überwachung aktiviert ist.

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter -Objekt mithilfe eines bereitgestellten ControlAdapter Objekt.

System_CAPS_protmethodResolveAdapter()

Ruft den Steuerelementadapter ab, für das Rendern des angegebenen Steuerelements verantwortlich.

System_CAPS_pubmethodResolveClientUrl(String)

Ruft eine URL, die vom Browser verwendet werden kann.

System_CAPS_pubmethodResolveUrl(String)

Konvertiert eine URL in eine, die auf dem anfordernden Client verwendet werden kann.

System_CAPS_protmethodSaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

System_CAPS_protmethodSaveViewState()

Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

System_CAPS_protmethodSetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Weist einen Ereignishandlerdelegaten für das Steuerelement und dessen Inhalt im übergeordneten Steuerelement zu rendern.

System_CAPS_pubmethodSetTraceData(Object, Object)

Legt die Ablaufverfolgungsdaten für die Entwurfszeit-Verfolgung von Daten unter Verwendung der Trace-Datenschlüssel und den Trace-Wert.

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Legt die Ablaufverfolgungsdaten für die Entwurfszeit-Verfolgung von Renderingdaten, indem Sie das verfolgte Objekt der Trace-Datenschlüssel und den Trace-Wert.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_protmethodTrackViewState()

Nachverfolgen von Änderungen am Ansichtszustand des Serversteuerelements verursacht, damit sie in des Serversteuerelements gespeichert werden können StateBag Objekt. Auf dieses Objekt kann über die Control.ViewState-Eigenschaft zugegriffen werden.

NameBeschreibung
System_CAPS_pubeventDataBinding

Tritt auf, wenn das Steuerelement an eine Datenquelle bindet.

System_CAPS_pubeventDisposed

Tritt auf, wenn ein Steuerelement aus dem Speicher freigegeben wird, die ist die letzte Phase des Lebenszyklus der ASP.NET-Seite angefordert wird.

System_CAPS_pubeventInit

Tritt auf, wenn das Steuerelement initialisiert wird, ist der erste Schritt im Lebenszyklus.

System_CAPS_pubeventLoad

Tritt auf, wenn das Steuerelement geladen wird die Page Objekt.

System_CAPS_pubeventPreRender

Tritt ein, nachdem die Control Objekt ist geladen, jedoch vor dem Rendern.

System_CAPS_pubeventUnload

Tritt auf, wenn das Steuerelement aus dem Speicher entladen wird.

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.GetDesignModeState.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.SetDesignModeState.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.SetOwnerControl.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter IParserAccessor.AddParsedSubObject.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter IControlBuilderAccessor.ControlBuilder.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter IControlDesignerAccessor.UserData.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter IDataBindingsAccessor.DataBindings.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter IDataBindingsAccessor.HasDataBindings.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter IExpressionsAccessor.Expressions.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter IExpressionsAccessor.HasExpressions.

NameBeschreibung
System_CAPS_pubmethodFindDataSourceControl()

Gibt die Datenquelle, die das Steuerelement für das angegebene Steuerelement zugeordnet ist.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Gibt die Feldvorlage für die angegebene Spalte in das angegebene Steuerelement Benennungscontainer zurück.(Definiert durch DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Gibt das Metatabelle für das enthaltende Datensteuerelement zurück.(Definiert durch DynamicDataExtensions.)

This is the primary class that you derive from when you develop custom ASP.NET server controls. T:System.Web.UI.Control does not have any user interface (UI) specific features. If you are authoring a control that does not have a UI, or combines other controls that render their own UI, derive from T:System.Web.UI.Control. If you are authoring a control that does have a UI, derive from T:System.Web.UI.WebControls.WebControl or any control in the N:System.Web.UI.WebControls namespace that provides an appropriate starting point for your custom control.

The T:System.Web.UI.Control class is the base class for all ASP.NET server controls, including custom controls, user controls, and pages. ASP.NET pages are instances of the T:System.Web.UI.Page class, which inherits from the T:System.Web.UI.Control class, and that handle requests for files that have an .aspx extension.

The T:System.Web.UI.Control class can directly or indirectly be used as part of the user interface for your Web application, and as such should be scrutinized to make sure best practices for writing secure code and securing applications are followed.

For general information on these topics, see Overview of Web Application Security Threats, NIB: Security Policy Best Practices, and Key Security Concepts. For more specific information, see Securing Standard Controls, How to: Display Safe Error Messages, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Introduction to the Validation Controls.

The following example demonstrates a custom server control that derives from the T:System.Web.UI.Control class. The InnerContent class overrides the M:System.Web.UI.Control.Render(System.Web.UI.HtmlTextWriter) method, checks to see if the class has any child controls on the page and determines whether the first child of the control is a literal control. If both of these conditions are met, the overridden method writes the HTML string <H2>Your Message:, the contents of the literal control, and a closing </H2> tag to the Web Forms page.

System_CAPS_security Sicherheit Hinweis

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

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

namespace SimpleControlSamples {

    public class InnerContent : Control {
	[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")] 
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }    
}

.NET Framework
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: