Control-Klasse
Definiert die Eigenschaften, Methoden und Ereignisse, die von allen ASP.NET-Serversteuerelementen gemeinsam genutzt werden.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(True)> _
<ThemeableAttribute(False)> _
Public Class Control
Implements IComponent, IDisposable, IParserAccessor, IUrlResolutionService, _
IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor
'Usage
Dim instance As Control
[BindableAttribute(true)]
[ThemeableAttribute(false)]
public class Control : IComponent, IDisposable, IParserAccessor,
IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor
[BindableAttribute(true)]
[ThemeableAttribute(false)]
public ref class Control : IComponent, IDisposable, IParserAccessor,
IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor
/** @attribute BindableAttribute(true) */
/** @attribute ThemeableAttribute(false) */
public class Control implements IComponent, IDisposable,
IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor,
IExpressionsAccessor
BindableAttribute(true)
ThemeableAttribute(false)
public class Control implements IComponent, IDisposable,
IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor,
IExpressionsAccessor
Hinweise
Dies ist die primäre Klasse für das Ableiten bei der Entwicklung benutzerdefinierter ASP.NET-Serversteuerelemente. Control verfügt über keine spezifischen Features für die Benutzeroberfläche. Wenn Sie ein Steuerelement ohne Benutzeroberfläche erstellen oder ein Steuerelement erstellen, das andere Steuerelemente mit eigener Benutzeroberfläche miteinander kombiniert, leiten Sie von Control ab. Wenn Sie ein Steuerelement ohne Benutzeroberfläche erstellen, leiten Sie von WebControl oder einem beliebigen Steuerelement im System.Web.UI.WebControls-Namespace ab, das einen geeigneten Anfangspunkt für das benutzerdefinierte Steuerelement bietet.
Die Control-Klasse ist die Basisklasse für alle ASP.NET-Serversteuerelemente, einschließlich benutzerdefinierter Steuerelemente, Benutzersteuerelemente und Seiten. ASP.NET-Seiten sind Instanzen der Page-Klasse, die von der Control-Klasse erbt, und Anfragen für Dateien mit der Erweiterung .aspx behandelt.
Die Control-Klasse kann direkt oder indirekt als Teil der Benutzeroberfläche für die Webanwendung verwendet werden. Aus diesem Grund sollte genau geprüft werden, ob die empfohlenen Vorgehensweisen zum Schreiben von sicherem Code und zur Sicherung von Anwendungen eingehalten wurden. Allgemeine Informationen zu diesen Themen finden Sie unter Übersicht über Sicherheitsrisiken bei Webanwendungen, Sicherheitsrichtlinien: Empfohlene Vorgehensweise und Schlüsselbegriffe der Sicherheit. Spezifischere Informationen finden Sie unter Sichern von Standardsteuerelementen, Gewusst wie: Anzeigen von sicheren Fehlermeldungen, Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Einführung in die Validierungssteuerelemente.
Beispiel
Im folgenden Beispiel wird ein benutzerdefiniertes Serversteuerelement veranschaulicht, das von der Control-Klasse abgeleitet ist. Die InnerContent-Klasse überschreibt die Control.Render-Methode, überprüft das Vorhandensein von untergeordneten Steuerelementen in der Klasse und stellt fest, ob es sich bei dem ersten untergeordneten Element des Steuerelements um ein literales Steuerelement handelt. Wenn diese beiden Bedingungen erfüllt sind, schreibt die überschriebene Methode die HTML-Zeichenfolge <H2>Ihre Nachricht: , Inhalt des literalen Steuerelements und ein schließendes </H2>-Tag in die Web Forms-Seite.
Option Explicit
Option Strict
Imports System
Imports System.Web
Imports System.Web.UI
Imports Microsoft.VisualBasic
Namespace SimpleControlSamples
Public Class InnerContent
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
Protected Overrides Sub Render(output As HtmlTextWriter)
If HasControls() And TypeOf Controls(0) Is LiteralControl Then
output.Write("<H2>Your message : ")
Controls(0).RenderControl(output)
output.Write("</H2>")
End If
End Sub 'Render
End Class 'InnerContent
End Namespace 'SimpleControlSamples
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>");
}
}
}
}
package SimpleControlSamples;
import System.*;
import System.Web.*;
import System.Web.UI.*;
public class InnerContent extends Control
{
/** @attribute System.Security.Permissions.PermissionSet(
System.Security.Permissions.SecurityAction.Demand, Name = "Execution")
*/
protected void Render(HtmlTextWriter output)
{
if (HasControls() &&
get_Controls().get_Item(0) instanceof LiteralControl) {
output.Write("<H2>Your message: ");
get_Controls().get_Item(0).RenderControl(output);
output.Write("</H2>");
}
} //Render
} //InnerContent
import System;
import System.Web;
import System.Web.UI;
import System.Security.Permissions;
package SimpleControlSamples {
public class InnerContent extends Control {
protected override function Render(output : HtmlTextWriter) {
var securityperm : SecurityPermission;
securityperm = new SecurityPermission(SecurityPermissionFlag.SerializationFormatter);
securityperm.Demand();
if ( (HasControls()) && (typeof(Controls[0]) == LiteralControl) ) {
output.Write("<H2>Your Message: " + (LiteralControl(Controls[0])).Text + "</H2>");
}
}
}
}
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.Control
Abgeleitete Klassen
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Control-Member
System.Web.UI-Namespace
Page
TemplateControl
LiteralControl
WebControl
Weitere Ressourcen
Entwickeln von benutzerdefinierten ASP.NET-Serversteuerelementen