RequiredFieldValidator.InitialValue-Eigenschaft

Artikel
08/20/2007

Ruft den Anfangswert des zugeordneten Eingabesteuerelements ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Property InitialValue As String
'Usage
Dim instance As RequiredFieldValidator
Dim value As String

value = instance.InitialValue

instance.InitialValue = value

[ThemeableAttribute(false)] 
public string InitialValue { get; set; }

[ThemeableAttribute(false)] 
public:
property String^ InitialValue {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_InitialValue ()

/** @property */
public void set_InitialValue (String value)

public function get InitialValue () : String

public function set InitialValue (value : String)

Eigenschaftenwert

Eine Zeichenfolge, die den Anfangswert des zugeordneten Eingabesteuerelements angibt. Der Standardwert ist String.Empty.

Hinweise

Mit dieser Eigenschaft können Sie den Anfangswert des Eingabesteuerelements angeben.

Die Validierung schlägt nur dann fehl, wenn der Wert des zugeordneten Eingabesteuerelements beim Verlust des Fokus diesem InitialValue entspricht.

Hinweis

Vor dem Ausführen der Validierung werden überschüssige Leerzeichen vor und nach der Zeichenfolge in der InitialValue-Eigenschaft und vor und nach der Zeichenfolge im Eingabesteuerelement entfernt.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.

Beispiel

Das folgende Beispiel veranschaulicht, wie mithilfe der InitialValue-Eigenschaft sichergestellt werden kann, dass der Benutzer einen Wert in das Textfeld eingibt.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<body>
 
   <form runat="server">

      <h3>RequiredFieldValidator InitialValue Example</h3>
 
      Name: 
      <asp:TextBox id="Text1" 
           Text="Enter a value" 
           runat="server"/>
 
      <asp:RequiredFieldValidator id="RequiredFieldValidator1" 
           InitialValue="Enter a value" 
           ControlToValidate="Text1"
           ErrorMessage="Required field!"
           runat="server"/>
 
      <p>
         
      <asp:Button id="Button1"
           Text="Validate" 
           runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<body>
 
   <form runat="server">

      <h3>RequiredFieldValidator InitialValue Example</h3>
 
      Name: 
      <asp:TextBox id="Text1" 
           Text="Enter a value" 
           runat="server"/>
 
      <asp:RequiredFieldValidator id="RequiredFieldValidator1" 
           InitialValue="Enter a value" 
           ControlToValidate="Text1"
           ErrorMessage="Required field!"
           runat="server"/>
 
      <p>
         
      <asp:Button id="Button1"
           Text="Validate" 
           runat="server"/>
 
   </form>
 
</body>
</html>

Das folgende Beispiel veranschaulicht, wie mithilfe der InitialValue-Eigenschaft sichergestellt werden kann, dass der Benutzer ein Element in einem Listenfeld auswählt.

Classic RequiredFieldValidator.InitialValue Example#2

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

RequiredFieldValidator-Klasse
RequiredFieldValidator-Member
System.Web.UI.WebControls-Namespace

Freigeben über