Freigeben über


BaseValidator Klasse

Definition

Dient als abstrakte Basisklasse für Überprüfungssteuerelemente.

public ref class BaseValidator abstract : System::Web::UI::WebControls::Label, System::Web::UI::IValidator
public abstract class BaseValidator : System.Web.UI.WebControls.Label, System.Web.UI.IValidator
type BaseValidator = class
    inherit Label
    interface IValidator
Public MustInherit Class BaseValidator
Inherits Label
Implements IValidator
Vererbung
BaseValidator
Abgeleitet
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie mehrere Überprüfungssteuerelemente verwenden, um zu überprüfen, ob der Benutzer einen gültigen Wert in ein TextBox Steuerelement eingibt.

Von Bedeutung

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>
<%@ Page Language="VB" AutoEventWireup="False" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Hinweise

Die BaseValidator Klasse stellt die Kernimplementierung für alle Überprüfungssteuerelemente bereit. Überprüfungssteuerelemente werden verwendet, um die Benutzereingabe in einem zugeordneten Eingabesteuerelement zu überprüfen. Wenn der Benutzer einen Wert eingibt, der die Überprüfung fehlschlägt, zeigt das Überprüfungssteuerelement eine Fehlermeldung an. Da ein Überprüfungssteuerelement vom Eingabesteuerelement getrennt ist, können Sie die Fehlermeldung an einer beliebigen Stelle auf der Seite relativ zum Eingabesteuerelement positionieren. ASP.NET stellt mehrere Überprüfungssteuerelemente bereit, die bestimmte Überprüfungstypen ausführen. In der folgenden Tabelle werden diese Steuerelemente beschrieben.

Überprüfungssteuerelement Beschreibung
CompareValidator Überprüft einen Wert anhand des in ein anderes Eingabesteuerelement eingegebenen Werts anhand eines konstanten Werts oder anhand eines richtigen Datentyps, indem die CompareValidator.Operator Eigenschaft auf ValidationCompareOperator.DataTypeCheck.
CustomValidator Überprüft einen Wert mithilfe einer vom Benutzer bereitgestellten benutzerdefinierten Überprüfungsroutine.
RangeValidator Überprüft, ob sich ein Wert innerhalb eines Wertebereichs befindet.
RegularExpressionValidator Überprüft einen Wert mithilfe eines regulären Ausdrucks.
RequiredFieldValidator Überprüft, ob ein Wert in ein erforderliches Feld eingegeben wurde.

Überprüfungssteuerelemente überprüfen immer das zugeordnete Eingabesteuerelement auf dem Server. Überprüfungssteuerelemente verfügen außerdem über eine vollständige clientseitige Implementierung, mit der skriptfähige Browser (z. B. Microsoft Internet Explorer, Version 4.0 und höher) eine Überprüfung auf dem Client durchführen können. Die clientseitige Überprüfung verbessert den Überprüfungsprozess, indem die Benutzereingabe überprüft wird, bevor sie an den Server gesendet wird. Auf diese Weise können Fehler auf dem Client erkannt werden, bevor das Formular übermittelt wird, wodurch der Roundtrip von Informationen vermieden wird, die für die serverseitige Überprüfung erforderlich sind.

Mehrere Überprüfungssteuerelemente können mit einem einzelnen Eingabesteuerelement verwendet werden, um verschiedene Kriterien zu überprüfen. Sie können z. B. mehrere Überprüfungssteuerelemente auf ein TextBox Steuerelement anwenden. Sie können ein RangeValidator Steuerelement verwenden, um sicherzustellen, dass sich der in das TextBox Steuerelement eingegebene Wert in einem festgelegten Bereich befindet, und ein RequiredFieldValidator Steuerelement, um sicherzustellen, dass der Benutzer einen Wert eingibt.

ASP.NET bietet viele Steuerelemente, die die Möglichkeit haben, auf dem Server zurück zu posten. Wenn eines dieser Steuerelemente seine CausesValidation Eigenschaft auf true"festgelegt" hat, wird die Überprüfung ausgeführt, wenn das Steuerelement wieder auf dem Server veröffentlicht wird. Die folgenden Steuerelemente haben die Möglichkeit, den Beitrag zurück auf den Server zu stellen:

Hinweis

Einige dieser Steuerelemente stellen nur dann wieder auf dem Server bereit, wenn die AutoPostBack Eigenschaft auf true".

Diese Steuerelemente verfügen jeweils über eine ValidationGroup Eigenschaft, die beim Festlegen nur die Überprüfungssteuerelemente innerhalb der angegebenen Gruppe überprüft, wenn das Steuerelement einen Beitrag zurück auf den Server auslöst. Um Überprüfungssteuerelemente zu gruppieren, legen Sie die ValidationGroup Eigenschaft jedes Überprüfungssteuerelements auf denselben Wert fest.

Verwenden Sie die ControlToValidate Eigenschaft, um ein Eingabesteuerelement einem Überprüfungssteuerelement zuzuordnen. Verwenden Sie die Eigenschaft, um den Text anzugeben, der in einem Überprüfungssteuerelement angezeigt werden soll, wenn die Text Überprüfung fehlschlägt. Sie können auch eine Zusammenfassung aller Steuerelemente anzeigen, bei denen die Überprüfung auf der Seite fehlschlägt, indem Sie ein ValidationSummary Steuerelement verwenden. Verwenden Sie die Eigenschaft, um den Text anzugeben, der ErrorMessage in einem ValidationSummary Steuerelement angezeigt werden soll.

Hinweis

Wenn Sie die ErrorMessage Eigenschaft festlegen, ohne die Text Eigenschaft festzulegen, wird der Wert der ErrorMessage Eigenschaft auch im Überprüfungssteuerelement angezeigt.

Bei verwendung von Validator-Steuerelementen sollten Sie immer die Ergebnisse der serverseitigen Überprüfung überprüfen, bevor Sie eine Verarbeitung durchführen. Nach einem Postback, aber bevor Die Ereignismethoden aufgerufen werden, ruft die Seite die Validator-Steuerelemente auf und aggregiert ihre Ergebnisse in der Page.IsValid Eigenschaft. (Sie können die Validator-Steuerelemente auch explizit mithilfe der Validate Methode aufrufen.) In Ihrem eigenen Code sollten Sie überprüfen, ob die Eigenschaft vor der Verarbeitung der Page.IsValid Eingabe zurückgegeben wird true . Obwohl skriptfähige Browser möglicherweise verhindern, dass ein Postback auf dem Client auftritt, wenn eine Überprüfung fehlgeschlagen ist, sollten Sie vor der Verarbeitung überprüfter Daten immer auch den Servercode einchecken Page.IsValid .

Sie können die Überprüfung auch manuell durchführen. Verwenden Sie die Page.Validate Methode, um alle Überprüfungssteuerelemente auf der Seite zu überprüfen. Einzelne Überprüfungssteuerelemente können mithilfe der Validate Methode des Steuerelements überprüft werden.

Hinweis

Wenn Sie die Page.IsValid Eigenschaft in einer Page_Load Methode verwenden, müssen Sie die Page.Validate Methode zuerst explizit aufrufen. Da die Überprüfung nach dem Control.Load Ereignis für die Seite auftritt, aber vor dem Ereignishandler für die Click Oder-Ereignisse Command wird die Page.IsValid Eigenschaft erst aktualisiert, wenn die Page.Validate Methode aufgerufen wird. Alternativ können Sie den Code anstelle der Page_Load Methode im Ereignishandler für das Click Ereignis oder Command das Ereignis platzieren.

Nicht alle Webserversteuerelemente unterstützen Überprüfungssteuerelemente. Die Standardsteuerelemente, die mit einem Überprüfungssteuerelement überprüft werden können, sind:

Hinweis

Damit ein Eingabesteuerelement überprüft werden kann, muss das System.Web.UI.ValidationPropertyAttribute Attribut auf das Steuerelement angewendet werden.

Hinweis

Wenn Sie Validator-Steuerelemente verwenden, die von einem UpdatePanel Steuerelement abgeleitet BaseValidator werden, stellen Sie sicher, dass sich das Validator-Steuerelement und das Steuerelement, dem es zugeordnet ist, im selben Bereich befinden. Weitere Informationen zur Verwendung des UpdatePanel Steuerelements für Partielle Seitenaktualisierungen finden Sie unter Partial-Page Rendering Overview.

Wenn die Überprüfung fehlschlägt, können Sie den Fokus auf das zugeordnete Eingabesteuerelement festlegen, indem Sie die SetFocusOnError Eigenschaft auf truefestlegen.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von BaseValidator, finden Sie im BaseValidator Konstruktor.

Zugänglichkeit

Informationen zum Konfigurieren dieses Steuerelements, sodass es Markup generiert, das den Barrierefreiheitsstandards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET undASP.NET Steuerelemente und Barrierefreiheit.

Hinweise für Ausführende

Wenn Sie von der BaseValidator Klasse erben, müssen Sie das folgende Element überschreiben: EvaluateIsValid().

Konstruktoren

Name Beschreibung
BaseValidator()

Initialisiert eine neue Instanz der BaseValidator-Klasse.

Eigenschaften

Name Beschreibung
AccessKey

Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können.

(Geerbt von WebControl)
Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AppRelativeTemplateSourceDirectory

Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält.

(Geerbt von Control)
AssociatedControlID

Diese Eigenschaft wird nicht unterstützt.

Attributes

Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen.

(Geerbt von WebControl)
BackColor

Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements.

(Geerbt von WebControl)
BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.

(Geerbt von Control)
BorderColor

Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
BorderStyle

Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements.

(Geerbt von WebControl)
BorderWidth

Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest.

(Geerbt von WebControl)
ChildControlsCreated

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

(Geerbt von Control)
ClientID

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

(Geerbt von Control)
ClientIDMode

Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird.

(Geerbt von Control)
Context

Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist.

(Geerbt von Control)
Controls

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

(Geerbt von Control)
ControlStyle

Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ControlStyleCreated

Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ControlToValidate

Ruft das zu überprüfende Eingabesteuerelement ab oder legt es fest.

CssClass

Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird.

(Geerbt von WebControl)
DataItemContainer

Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird.

(Geerbt von Control)
DesignMode

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

(Geerbt von Control)
Display

Dient zum Abrufen oder Festlegen des Anzeigeverhaltens der Fehlermeldung in einem Überprüfungssteuerelement.

EnableClientScript

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die clientseitige Überprüfung aktiviert ist.

Enabled

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Überprüfungssteuerelement aktiviert ist.

EnableTheming

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten.

(Geerbt von WebControl)
EnableViewState

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält.

(Geerbt von Control)
ErrorMessage

Ruft den Text für die Fehlermeldung ab, die in einem ValidationSummary Steuerelement angezeigt wird, wenn die Überprüfung fehlschlägt, oder legt diesen fest.

Events

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

(Geerbt von Control)
Font

Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind.

(Geerbt von WebControl)
ForeColor

Ruft die Farbe der Meldung ab, die angezeigt wird, wenn die Überprüfung fehlschlägt, oder legt sie fest.

HasAttributes

Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat.

(Geerbt von WebControl)
HasChildViewState

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen.

(Geerbt von Control)
Height

Ruft die Höhe des Webserversteuerelements ab oder legt sie fest.

(Geerbt von WebControl)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird.

(Geerbt von Control)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen.

(Geerbt von Control)
IsEnabled

Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist.

(Geerbt von WebControl)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert.

(Geerbt von Control)
IsUnobtrusive

Ruft einen Wert ab, der angibt, ob das Steuerelement unauffälliges JavaScript generiert.

IsValid

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das zugeordnete Eingabesteuerelement die Überprüfung bestanden hat.

IsViewStateEnabled

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

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab.

(Geerbt von Control)
PropertiesValid

Ruft einen Wert ab, der angibt, ob das durch die ControlToValidate Eigenschaft angegebene Steuerelement ein gültiges Steuerelement ist.

RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist.

(Geerbt von Control)
RenderUplevel

Ruft einen Wert ab, der angibt, ob der Browser des Clients "uplevel"-Rendering unterstützt.

SetFocusOnError

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Fokus auf das von der Eigenschaft angegebene Steuerelement festgelegt ist, wenn die ControlToValidate Überprüfung fehlschlägt.

Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest.

(Geerbt von WebControl)
Style

Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden.

(Geerbt von WebControl)
SupportsDisabledAttribute

Ruft einen Wert ab, der angibt, ob das Steuerelement das disabled Attribut des gerenderten HTML-Elements auf "disabled" festlegen soll, wenn die Eigenschaft des Steuerelements IsEnabled ist false.

(Geerbt von Label)
TabIndex

Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements.

(Geerbt von WebControl)
TagKey

Ruft das HTML-Tag ab, das zum Rendern des Label Steuerelements verwendet wird.

(Geerbt von Label)
TagName

Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
TemplateControl

Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab.

(Geerbt von Control)
Text

Ruft den Text ab, der im Überprüfungssteuerelement angezeigt wird, wenn die Überprüfung fehlschlägt, oder legt diesen fest.

Text

Dient zum Abrufen oder Festlegen des Textinhalts des Label Steuerelements.

(Geerbt von Label)
ToolTip

Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest.

(Geerbt von WebControl)
UniqueID

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

(Geerbt von Control)
ValidateRequestMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft.

(Geerbt von Control)
ValidationGroup

Dient zum Abrufen oder Festlegen des Namens der Überprüfungsgruppe, zu der dieses Überprüfungssteuerelement gehört.

ViewState

Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest.

(Geerbt von Control)
Visible

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird.

(Geerbt von Control)
Width

Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements.

(Geerbt von WebControl)

Methoden

Name Beschreibung
AddAttributesToRender(HtmlTextWriter)

Fügt die HTML-Attribute und -Formatvorlagen hinzu, die für das Steuerelement dem angegebenen HtmlTextWriter Objekt gerendert werden müssen.

AddedControl(Control, Int32)

Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Steuerelement, dass ein Element analysiert wurde, und fügt das Element dem Label Steuerelement hinzu.

(Geerbt von Label)
ApplyStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ApplyStyleSheetSkin(Page)

Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
CheckControlValidationProperty(String, String)

Überprüft, ob sich das angegebene Steuerelement auf der Seite befindet und Überprüfungseigenschaften enthält.

ClearCachedClientID()

Legt den zwischengespeicherten ClientID Wert auf null.

(Geerbt von Control)
ClearChildControlState()

Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit.

(Geerbt von Control)
ControlPropertiesValid()

Bestimmt, ob das durch die ControlToValidate Eigenschaft angegebene Steuerelement ein gültiges Steuerelement ist.

CopyBaseAttributes(WebControl)

Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
CreateChildControls()

Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält.

(Geerbt von Control)
CreateControlStyle()

Erstellt das Formatvorlagenobjekt, das intern von der WebControl Klasse verwendet wird, um alle formatbezogenen Eigenschaften zu implementieren. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
DataBind()

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

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
DetermineRenderUplevel()

Bestimmt, ob das Überprüfungssteuerelement clientseitige Überprüfungen ausführen kann.

Dispose()

Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung von Renderingdaten.

(Geerbt von Control)
EnsureChildControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
EvaluateIsValid()

Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, enthält diese Methode den Code, um zu bestimmen, ob der Wert im Eingabesteuerelement gültig ist.

FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen id und einer ganzzahligen Zahl, die pathOffset im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen.

(Geerbt von Control)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen id Parameter.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
GetControlRenderID(String)

Ruft die Client-ID des angegebenen Steuerelements ab.

GetControlValidationValue(String)

Ruft den Wert ab, der dem angegebenen Eingabesteuerelement zugeordnet ist.

GetDesignModeState()

Ruft Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(String, Object)

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

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

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

(Geerbt von Control)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
GetValidationProperty(Object)

Bestimmt die Gültigkeitsprüfungseigenschaft eines Steuerelements (sofern vorhanden).

HasControls()

Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind.

(Geerbt von Control)
IsLiteralContent()

Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält.

(Geerbt von Control)
LoadControlState(Object)

Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde.

(Geerbt von Control)
LoadViewState(Object)

Lädt den zuvor gespeicherten Zustand für das Steuerelement.

(Geerbt von Label)
MapPathSecure(String)

Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MergeStyle(Style)

Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird.

(Geerbt von Control)
OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

(Geerbt von Control)
OnInit(EventArgs)

Löst das Init-Ereignis aus.

OnLoad(EventArgs)

Löst das Load-Ereignis aus.

(Geerbt von Control)
OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus.

OnUnload(EventArgs)

Löst das Unload-Ereignis aus.

OpenFile(String)

Ruft einen Stream Verwendeten zum Lesen einer Datei ab.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu.

(Geerbt von Control)
RegisterValidatorCommonScript()

Registriert Code auf der Seite für die clientseitige Überprüfung.

RegisterValidatorDeclaration()

Registriert eine ECMAScript-Arraydeklaration mithilfe des Arraynamens Page_Validators.

RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde.

(Geerbt von Control)
Render(HtmlTextWriter)

Zeigt das Steuerelement auf dem Client an.

RenderBeginTag(HtmlTextWriter)

Rendert das HTML-Öffnungstag des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll.

(Geerbt von Control)
RenderContents(HtmlTextWriter)

Rendert den Inhalt des Inhalts in Label den angegebenen Writer.

(Geerbt von Label)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriterControlAdapter Objekt aus.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
RenderEndTag(HtmlTextWriter)

Rendert das HTML-Schließen-Tag des Steuerelements in den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet.

(Geerbt von WebControl)
ResolveAdapter()

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

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.

(Geerbt von Control)
ResolveUrl(String)

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

(Geerbt von Control)
SaveControlState()

Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind.

(Geerbt von Control)
SaveViewState()

Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState() Methode aufgerufen wurde.

(Geerbt von WebControl)
SetDesignModeState(IDictionary)

Legt Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)

Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern.

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

Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Bewirkt, dass das Steuerelement Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des ViewState Objekts gespeichert werden können.

(Geerbt von WebControl)
Validate()

Führt eine Überprüfung des zugehörigen Eingabesteuerelements durch und aktualisiert die IsValid Eigenschaft.

Ereignisse

Name Beschreibung
DataBinding

Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt.

(Geerbt von Control)
Disposed

Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird.

(Geerbt von Control)
Init

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

(Geerbt von Control)
Load

Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird.

(Geerbt von Control)
PreRender

Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern.

(Geerbt von Control)
Unload

Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IAttributeAccessor.GetAttribute(String)

Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab.

(Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)

Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest.

(Geerbt von WebControl)
IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Mitglieds finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Mitglieds finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)

Erweiterungsmethoden

Name Beschreibung
FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.

FindMetaTable(Control)

Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen