UserControl Klasse

Definition

Stellt eine ASCX-Datei dar, die auch als Benutzersteuerelement bezeichnet wird und die von einem Server angefordert wurde, der Host einer ASP.NET-Webanwendung ist.Represents an .ascx file, also known as a user control, requested from a server that hosts an ASP.NET Web application. Die Datei muss von einer Web Forms-Seite aufgerufen werden, da andernfalls ein Parserfehler auftritt.The file must be called from a Web Forms page or a parser error will occur.

public ref class UserControl : System::Web::UI::TemplateControl, System::Web::UI::IAttributeAccessor, System::Web::UI::IUserControlDesignerAccessor
public class UserControl : System.Web.UI.TemplateControl, System.Web.UI.IAttributeAccessor, System.Web.UI.IUserControlDesignerAccessor
type UserControl = class
    inherit TemplateControl
    interface IAttributeAccessor
    interface INamingContainer
    interface IUserControlDesignerAccessor
Public Class UserControl
Inherits TemplateControl
Implements IAttributeAccessor, IUserControlDesignerAccessor
Vererbung
Abgeleitet
Implementiert

Beispiele

Die im folgenden Beispiel SimpleControldefinierte Klasse erbt die UserControl -Klasse und kann als ASP.NET-Code Behind-Klasse verwendet werden.The class defined in the following example, SimpleControl, inherits the UserControl class and can be used as an ASP.NET code-behind class. Es verwendet die TextBoxWebserver LabelSteuer Button myButton_Click Elemente,Label.Text und und definiert eine Methode, die den EigenschaftsWertzusammenmitzweiZeichenfolgenderEigenschaftzuweist.TextBox.TextIt uses the TextBox, Label, and Button Web server controls and defines a myButton_Click method that assigns the TextBox.Text property value, along with two strings, to the Label.Text property.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

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

public class SimpleControl:UserControl
{

  public TextBox name;
  public Label output;
  public Button myButton;

  public void myButton_Click(object sender, EventArgs e)
  { 
    output.Text = "Hello, " + name.Text + ".";

  }
 
}
Imports System.Web.UI
Imports System.Web.UI.WebControls


Public Class SimpleControl
   Inherits UserControl
   Public name As TextBox
   Public output As Label
   Public myButton As Button
   
   
   Public Sub myButton_Click(sender As Object, e As EventArgs)

      output.Text = "Hello, " + name.Text + "."

   End Sub  

End Class

Das folgende Beispiel ist ein Markup, das in einer ASCX-Datei enthalten ist.The following example is markup contained in an .ascx file. Sie können die SimpleControl im vorherigen Beispiel definierte-Klasse als Code-Behind-Klasse für das Markup in dieser ASCX-Datei verwenden.You can use the SimpleControl class defined in the previous example as a code-behind class for the markup in this .ascx file.

<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>

<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
<%@ control inherits = "SimpleControl" src = "SimpleControl.vb" %>

<table style="background-color: yellow; font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>

Hinweise

Die UserControl -Klasse ist Dateien zugeordnet, die über ASCX-Erweiterungen verfügen.The UserControl class is associated with files that have .ascx extensions. Diese Dateien werden zur Laufzeit als UserControl Objekte kompiliert und im Server Speicher zwischengespeichert.These files are compiled at run time as UserControl objects and cached in server memory.

Sie können Benutzer Steuerelemente Schachteln, indem Sie eine ASCX-Datei in einer anderen, einschließlich der letzteren, auf einer Web Forms Seite deklarieren.You can nest user controls by declaring one .ascx file in another including the latter in a Web Forms page.

Benutzer Steuerelemente sind in ASP.net Web Forms Seiten enthalten und bieten Webentwicklern eine einfache Möglichkeit, die häufig verwendete Webbenutzer Oberfläche zu erfassen.User controls are contained in ASP.NET Web Forms pages, and offer Web developers an easy way to capture commonly used Web UI. Sie werden instanziiert und auf ähnliche Weise wie Page -Objekte zwischengespeichert.They are instantiated and cached in ways similar to Page objects. Anders als bei Seiten können Benutzer Steuerelemente jedoch nicht unabhängig aufgerufen werden.Unlike pages, however, user controls cannot be called independently. Sie können nur von der Seite oder von einem anderen Benutzer Steuerelement aufgerufen werden, das Sie enthält.They can only be called from the page or other user control that contains them.

Leiten Sie von dieser Klasse ab, wenn Sie ein Benutzer Steuerelement mit der Code-Behind-Technik erstellen möchten.Derive from this class if you want to create a user control using the code-behind technique. Dies wird empfohlen, wenn Sie Web Forms Seiten mithilfe dieser Technik entwickeln.This is recommended if you are developing Web Forms pages using this technique.

Weitere Informationen zum deklarativen Erstellen von Benutzer Steuerelementen finden Sie unter ASP.NET User Controls.For information about creating user controls declaratively, see ASP.NET User Controls.

Konstruktoren

UserControl()

Initialisiert eine neue Instanz der UserControl-Klasse.Initializes a new instance of the UserControl class.

Eigenschaften

Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.Gets the browser-specific adapter for the control.

(Geerbt von Control)
Application

Ruft das Application-Objekt für die aktuelle Webanforderung ab.Gets the Application object for the current Web request.

AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Geerbt von Control)
AppRelativeVirtualPath

Ruft den anwendungsbezogenen virtuellen Verzeichnispfad zur Datei ab, von der aus das Steuerelement analysiert und kompiliert wird, oder legt diesen fest.Gets or sets the application-relative, virtual directory path to the file from which the control is parsed and compiled.

(Geerbt von TemplateControl)
Attributes

Ruft eine Auflistung aller Attributname-Wert-Paare ab, die innerhalb der ASPX-Datei im Benutzersteuerelementtag deklariert sind.Gets a collection of all attribute name and value pairs declared in the user control tag within the .aspx file.

AutoHandlers

Die AutoHandlers-Eigenschaft ist seit ASP.NET-Version 2.0 veraltet.The AutoHandlers property has been deprecated in ASP.NET NET 2.0. Sie wird von generierten Klassen verwendet und ist nicht zur Verwendung im Code bestimmt.It is used by generated classes and is not intended for use within your code.

(Geerbt von TemplateControl)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.Gets the control that contains this control's data binding.

(Geerbt von Control)
Cache

Ruft das Cache-Objekt ab, das der Anwendung zugeordnet ist, die das Benutzersteuerelement enthält.Gets the Cache object that is associated with the application that contains the user control.

CachePolicy

Ruft einen Verweis auf eine Auflistung von Zwischenspeicherungsparametern für dieses Benutzersteuerelement ab.Gets a reference to a collection of caching parameters for this user control.

ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.Gets a value that indicates whether the server control's child controls have been created.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.Gets the control ID for HTML markup that is generated by ASP.NET.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.Gets a character value representing the separator character used in the ClientID property.

(Geerbt von Control)
Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.Gets the HttpContext object associated with the server control for the current Web request.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Geerbt von Control)
DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Geerbt von Control)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.Gets a value indicating whether a control is being used on a design surface.

(Geerbt von Control)
EnableTheming

Ruft einen booleschen Wert ab, der angibt, ob Designs für das Steuerelement gelten, das von der TemplateControl-Klasse abgeleitet wird, oder legt diesen Wert fest.Gets or sets a Boolean value indicating whether themes apply to the control that is derived from the TemplateControl class.

(Geerbt von TemplateControl)
EnableViewState

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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab.Gets a list of event handler delegates for the control. Diese Eigenschaft ist schreibgeschützt.This property is read-only.

(Geerbt von Control)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Geerbt von Control)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.Gets or sets the programmatic identifier assigned to the server control.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.Gets the character used to separate control identifiers.

(Geerbt von Control)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.Gets a value indicating whether controls contained within this control have control state.

(Geerbt von Control)
IsPostBack

Ruft einen Wert ab, der angibt, ob das Benutzersteuerelement als Antwort auf ein Postback des Clients geladen wird oder ob das Laden und der Zugriff zum ersten Mal erfolgen.Gets a value indicating whether the user control is being loaded in response to a client postback, or if it is being loaded and accessed for the first time.

IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.Gets a value that indicates whether the server control is saving changes to its view state.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.Gets a value indicating whether view state is enabled for this control.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.Gets a reference to the Page instance that contains the server control.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.Gets a reference to the server control's parent control in the page control hierarchy.

(Geerbt von Control)
RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Geerbt von Control)
Request

Ruft das HttpRequest-Objekt für die aktuelle Webanforderung ab.Gets the HttpRequest object for the current Web request.

Response

Ruft das HttpResponse-Objekt für die aktuelle Webanforderung ab.Gets the HttpResponse object for the current Web request.

Server

Ruft das HttpServerUtility-Objekt für die aktuelle Webanforderung ab.Gets the HttpServerUtility object for the current Web request.

Session

Ruft das HttpSessionState-Objekt für die aktuelle Webanforderung ab.Gets the HttpSessionState object for the current Web request.

Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.Gets information about the container that hosts the current control when rendered on a design surface.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.Gets or sets the skin to apply to the control.

(Geerbt von Control)
SupportAutoEvents

Ruft einen Wert ab, der angibt, ob das TemplateControl-Steuerelement automatische Ereignisse unterstützt.Gets a value indicating whether the TemplateControl control supports automatic events.

(Geerbt von TemplateControl)
TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.Gets or sets a reference to the template that contains this control.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Geerbt von Control)
Trace

Ruft das TraceContext-Objekt für die aktuelle Webanforderung ab.Gets the TraceContext object for the current Web request.

UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.Gets the unique, hierarchically qualified identifier for the server control.

(Geerbt von Control)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.Gets a value that indicates whether the StateBag object is case-insensitive.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.Gets or sets the view-state mode of this control.

(Geerbt von Control)
Visible

Ruft einen Wert ab, der angibt, ob ein Serversteuerelement auf der Seite als Benutzeroberfläche gerendert wird.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Geerbt von Control)

Methoden

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.Called after a child control is added to the Controls collection of the Control object.

(Geerbt von Control)
AddParsedSubObject(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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Geerbt von Control)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.Applies the style properties defined in the page style sheet to the control.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.Begins design-time tracing of rendering data.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.Sets the cached ClientID value to null.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.Deletes the control-state information for the server control's child controls.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state and control-state information for all the server control's child controls.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.Deletes the view-state information for all the server control's child controls.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Geerbt von Control)
Construct()

Führt die Entwurfszeitlogik aus.Performs design-time logic.

(Geerbt von TemplateControl)
CreateChildControls()

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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Geerbt von Control)
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)

Greift auf die in einer Ressource gespeicherten Literalzeichenfolgen zu.Accesses literal strings stored in a resource. Die CreateResourceBasedLiteralControl(Int32, Int32, Boolean)-Methode ist nicht für die Verwendung aus dem Code heraus vorgesehen.The CreateResourceBasedLiteralControl(Int32, Int32, Boolean) method is not intended for use from within your code.

(Geerbt von TemplateControl)
DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.Binds a data source to the invoked server control and all its child controls.

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.Binds a data source to the server control's child controls.

(Geerbt von Control)
DesignerInitialize()

Führt alle für RAD-Designer erforderlichen Initialisierungsschritte am Benutzersteuerelement aus.Performs any initialization steps on the user control that are required by RAD designers.

Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.Enables a server control to perform final clean up before it is released from memory.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.Ends design-time tracing of rendering data.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines whether the server control contains child controls. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.If it does not, it creates child controls.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.Creates an identifier for controls that do not have an identifier assigned.

(Geerbt von Control)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Eval(String)

Wertet einen Datenbindungsausdruck aus.Evaluates a data-binding expression.

(Geerbt von TemplateControl)
Eval(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.Evaluates a data-binding expression using the specified format string to display the result.

(Geerbt von TemplateControl)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.Searches the current naming container for a server control with the specified id parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Sie sollten diese Version der FindControl-Methode nicht überschreiben.You should not override this version of the FindControl method.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.Sets input focus to a control.

(Geerbt von Control)
FrameworkInitialize()

Initialisiert das Steuerelement, das von der TemplateControl-Klasse abgeleitet wurde.Initializes the control that is derived from the TemplateControl class.

(Geerbt von TemplateControl)
GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.Gets design-time data for a control.

(Geerbt von Control)
GetGlobalResourceObject(String, String)

Ruft auf der Grundlage der angegebenen ClassKey-Eigenschaft und ResourceKey-Eigenschaft ein Ressourcenobjekt auf Anwendungsebene ab.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

(Geerbt von TemplateControl)
GetGlobalResourceObject(String, String, Type, String)

Ruft ein Ressourcenobjekt auf Anwendungsebene ab, das auf den Angaben zur ClassKey-Eigenschaft und zur ResourceKey-Eigenschaft, zum Objekttyp und zum Eigenschaftennamen der Ressource basiert.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, object type, and property name of the resource.

(Geerbt von TemplateControl)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetLocalResourceObject(String)

Ruft auf der Grundlage der angegebenen ResourceKey-Eigenschaft ein Ressourcenobjekt auf Seitenebene ab.Gets a page-level resource object based on the specified ResourceKey property.

(Geerbt von TemplateControl)
GetLocalResourceObject(String, Type, String)

Ruft auf der Grundlage der angegebenen ResourceKey-Eigenschaft sowie des angegebenen Objekttyps und Eigenschaftennamens ein Ressourcenobjekt auf Seitenebene ab.Gets a page-level resource object based on the specified ResourceKey property, object type, and property name.

(Geerbt von TemplateControl)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.Gets the URL that corresponds to a set of route parameters.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.Gets the URL that corresponds to a set of route parameters and a route name.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.Returns the prefixed portion of the UniqueID property of the specified control.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.Determines if the server control contains any child controls.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.Returns a value indicating whether events are registered for the control or any child controls.

(Geerbt von Control)
InitializeAsUserControl(Page)

Initialisiert das deklarativ erstellte UserControl-Objekt.Initializes the UserControl object that has been created declaratively. Da einige Unterschiede zwischen Seiten und Benutzersteuerelementen bestehen, stellt diese Methode sicher, dass das Benutzersteuerelement fehlerfrei initialisiert wird.Since there are some differences between pages and user controls, this method makes sure that the user control is initialized properly.

IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.Determines if the server control holds only literal content.

(Geerbt von Control)
LoadControl(String)

Lädt ein Control-Objekt aus einer Datei auf der Grundlage eines angegebenen virtuellen Pfads.Loads a Control object from a file based on a specified virtual path.

(Geerbt von TemplateControl)
LoadControl(Type, Object[])

Lädt auf der Grundlage eines angegebenen Typs und der angegebenen Konstruktorparameter ein Control-Objekt.Loads a Control object based on a specified type and constructor parameters.

(Geerbt von TemplateControl)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Geerbt von Control)
LoadTemplate(String)

Ruft aus einer externen Datei eine Instanz der ITemplate-Schnittstelle ab.Obtains an instance of the ITemplate interface from an external file.

(Geerbt von TemplateControl)
LoadViewState(Object)

Stellt die Ansichtszustandsinformationen aus einer früheren Benutzersteuerelementanforderung wieder her, die von der SaveViewState()-Methode gespeichert wurde.Restores the view-state information from a previous user control request that was saved by the SaveViewState() method.

MapPath(String)

Weist einem physischen Dateipfad einen absoluten oder relativen virtuellen Dateipfad zu.Assigns a virtual file path, either absolute or relative, to a physical file path.

MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnAbortTransaction(EventArgs)

Löst das AbortTransaction-Ereignis aus.Raises the AbortTransaction event.

(Geerbt von TemplateControl)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Geerbt von Control)
OnCommitTransaction(EventArgs)

Löst das CommitTransaction-Ereignis aus.Raises the CommitTransaction event.

(Geerbt von TemplateControl)
OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.Raises the DataBinding event.

(Geerbt von Control)
OnError(EventArgs)

Löst das Error-Ereignis aus.Raises the Error event.

(Geerbt von TemplateControl)
OnInit(EventArgs)

Löst das Init-Ereignis aus.Raises the Init event.

OnLoad(EventArgs)

Löst das Load-Ereignis aus.Raises the Load event.

(Geerbt von Control)
OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.Raises the PreRender event.

(Geerbt von Control)
OnUnload(EventArgs)

Löst das Unload-Ereignis aus.Raises the Unload event.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.Gets a Stream used to read a file.

(Geerbt von Control)
ParseControl(String)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt in einer Web Forms-Seite oder einem Benutzersteuerelement.Parses an input string into a Control object on the Web Forms page or user control.

(Geerbt von TemplateControl)
ParseControl(String, Boolean)

Analysiert eine Eingabezeichenfolge für ein Control-Objekt auf einer ASP.NET-Webseite oder in einem Benutzersteuerelement.Parses an input string into a Control object on the ASP.NET Web page or user control.

(Geerbt von TemplateControl)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.Assigns any sources of the event and its information to the control's parent.

(Geerbt von Control)
ReadStringResource()

Liest eine Zeichenfolgenressource.Reads a string resource. Die ReadStringResource()-Methode ist nicht für die Verwendung aus dem Code heraus vorgesehen.The ReadStringResource() method is not intended for use from within your code.

(Geerbt von TemplateControl)
RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.Called after a child control is removed from the Controls collection of the Control object.

(Geerbt von Control)
Render(HtmlTextWriter)

Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Geerbt von Control)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Geerbt von Control)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.Gets the control adapter responsible for rendering the specified control.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.Gets a URL that can be used by the browser.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.Converts a URL into one that is usable on the requesting client.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Geerbt von Control)
SaveViewState()

Speichert alle Änderungen im Ansichtszustand des Steuerelements, die seit dem letzten Postback der Seite aufgetreten sind.Saves any user control view-state changes that have occurred since the last page postback.

SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.Sets design-time data for a control.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.Assigns an event handler delegate to render the server control and its content into its parent control.

(Geerbt von Control)
SetStringResourcePointer(Object, Int32)

Legt einen Zeiger auf eine Zeichenfolgenressource fest.Sets a pointer to a string resource. Die SetStringResourcePointer(Object, Int32)-Methode wird von generierten Klassen verwendet und ist nicht für die direkte Verwendung im Code vorgesehen.The SetStringResourcePointer(Object, Int32) method is used by generated classes and is not intended for use from within your code.

(Geerbt von TemplateControl)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Geerbt von Control)
TestDeviceFilter(String)

Gibt einen booleschen Wert zurück, der angibt, ob ein Gerätefilter auf die HTTP-Anforderung angewendet wird.Returns a Boolean value indicating whether a device filter applies to the HTTP request.

(Geerbt von TemplateControl)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TrackViewState()

Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden.This object is accessible through the ViewState property.

(Geerbt von Control)
TryUpdateModel<TModel>(TModel)

Versucht, die Modellinstanz mit Werten vom datengebundenen Steuerelement zu aktualisieren.Attempts to update the model instance by using the values from the data-bound control.

TryUpdateModel<TModel>(TModel, IValueProvider)

Versucht, die Modellinstanz mit Werten vom Wertanbieter zu aktualisieren.Attempts to update the model instance using values from the value provider.

UpdateModel<TModel>(TModel)

Aktualisiert die Modellinstanz mithilfe von Werten aus dem datengebundenen Steuerelement.Updates the model instance by using values from the data-bound control.

UpdateModel<TModel>(TModel, IValueProvider)

Aktualisiert die angegebene Modellinstanz mit von Werten vom Wertanbieter des Benutzersteuerelements.Updates the specified model instance using values from the value provider of the user control.

WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)

Schreibt eine Ressourcenzeichenfolge in ein HtmlTextWriter-Steuerelement.Writes a resource string to an HtmlTextWriter control. Die WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)-Methode wird von generierten Klassen verwendet und ist nicht für die direkte Verwendung im Code vorgesehen.The WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) method is used by generated classes and is not intended for use from within your code.

(Geerbt von TemplateControl)
XPath(String)

Wertet einen XPath-Datenbindungsausdruck aus.Evaluates an XPath data-binding expression.

(Geerbt von TemplateControl)
XPath(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

(Geerbt von TemplateControl)
XPath(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.Evaluates an XPath data-binding expression using the specified format string to display the result.

(Geerbt von TemplateControl)
XPath(String, String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und zeigt mit der angegebenen Formatzeichenfolge das Ergebnis an.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

(Geerbt von TemplateControl)
XPathSelect(String)

Wertet einen XPath-Datenbindungsausdruck aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.Evaluates an XPath data-binding expression and returns a node collection that implements the IEnumerable interface.

(Geerbt von TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the IEnumerable interface.

(Geerbt von TemplateControl)

Ereignisse

AbortTransaction

Tritt ein, wenn ein Benutzer eine Transaktion beendet.Occurs when a user ends a transaction.

(Geerbt von TemplateControl)
CommitTransaction

Tritt ein, wenn eine Transaktion abgeschlossen wird.Occurs when a transaction completes.

(Geerbt von TemplateControl)
DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.Occurs when the server control binds to a data source.

(Geerbt von Control)
Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Geerbt von Control)
Error

Tritt beim Auslösen einer nicht behandelten Ausnahme ein.Occurs when an unhandled exception is thrown.

(Geerbt von TemplateControl)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Geerbt von Control)
Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.Occurs when the server control is loaded into the Page object.

(Geerbt von Control)
PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.Occurs after the Control object is loaded but prior to rendering.

(Geerbt von Control)
Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.Occurs when the server control is unloaded from memory.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

IAttributeAccessor.GetAttribute(String)

Gibt den Wert des angegebenen Benutzersteuerelement-Attributs zurück.Returns the value of the specified user control attribute.

IAttributeAccessor.SetAttribute(String, String)

Legt den Wert des angegebenen Benutzersteuerelement-Attributs fest.Sets the value of the specified user control attribute.

IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.For a description of this member, see ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().For a description of this member, see GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.For a description of this member, see UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.For a description of this member, see DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.For a description of this member, see HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.For a description of this member, see Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.For a description of this member, see HasExpressions.

(Geerbt von Control)
IFilterResolutionService.CompareFilters(String, String)

Gibt einen Wert zurück, der angibt, ob zwischen zwei angegeben Gerätefiltern eine Beziehung zwischen übergeordnetem und untergeordnetem Element existiert.Returns a value that indicates whether a parent/child relationship exists between two specified device filters.

(Geerbt von TemplateControl)
IFilterResolutionService.EvaluateFilter(String)

Gibt einen Wert zurück, der angibt, ob der angegebene Filter ein Typ des aktuellen Filterobjekts ist.Returns a value that indicates whether the specified filter is a type of the current filter object.

(Geerbt von TemplateControl)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Geerbt von Control)
IUserControlDesignerAccessor.InnerText

Ruft den Text zwischen den öffnenden und schließenden Tags eines Benutzersteuerelements ab oder legt diesen fest.Gets or sets the text that appears between the opening and closing tags of a user control.

IUserControlDesignerAccessor.TagName

Ruft den vollständigen Tagnamen für das Benutzersteuerelement ab oder legt diesen fest.Gets or sets the full tag name of the user control.

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Aktiviert das Verhalten dynamischer Daten für das angegebene DatensteuerelementEnables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Verhalten dynamischer Daten für das angegebene DatensteuerelementEnables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Verhalten dynamischer Daten für das angegebene DatensteuerelementEnables Dynamic Data behavior for the specified data control.

Gilt für:

Siehe auch