Parameter.DefaultValue Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt einen Standardwert für den Parameter an, wenn der Wert, an den der Parameter gebunden ist, beim Aufrufen der Evaluate(HttpContext, Control)-Methode nicht initialisiert ist.

public:
 property System::String ^ DefaultValue { System::String ^ get(); void set(System::String ^ value); };

public string DefaultValue { get; set; }

member this.DefaultValue : string with get, set

Public Property DefaultValue As String

Eigenschaftswert

String

Eine Zeichenfolge, die als Standardwert für den Parameter verwendet wird, wenn der Wert, an den er gebunden ist, nicht aufgelöst werden kann oder nicht initialisiert ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein einzelner Datensatz mithilfe eines Steuerelements ObjectDataSource abgerufen und in einem DetailsView Steuerelement angezeigt wird. Das ObjectDataSource -Steuerelement ruft einen bestimmten Mitarbeiterdatensatz ab, indem die GetEmployee -Methode der EmployeeLogic -Klasse aufgerufen wird. Die GetEmployee -Methode erfordert einen Mitarbeiter-ID-Parameter. Das ObjectDataSource -Steuerelement verwendet ein QueryStringParameter -Objekt in seiner SelectParameters Auflistung, um eine ID an die GetEmployee -Methode in diesem Beispiel zu übergeben.

Die Beispielimplementierung der EmployeeLogic -Klasse und der GetEmployee -Methode finden Sie in der Übersicht über die ObjectDataSource Klasse.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.VB.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

Hinweise

Die DefaultValue -Eigenschaft wird in Szenarien verwendet, in denen der Parameter an einen Wert gebunden ist, der Wert aber bei der Auswertung des Parameter Objekts aufgelöst wird null oder nicht aufgelöst werden kann.

Wenn die DefaultValue -Eigenschaft des Parameters geändert wird, wird die OnParameterChanged -Methode aufgerufen.

Gilt für: