Parameter.DefaultValue Eigenschaft

Definition

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.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called.

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

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.A string that serves as a default value for the Parameter when the value it is bound to cannot be resolved or is uninitialized.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein einzelner Datensatz mit einem ObjectDataSource -Steuerelement abgerufen und in einem DetailsView -Steuerelement angezeigt wird.The following code example demonstrates how to retrieve a single data record using an ObjectDataSource control and display it in a DetailsView control. Das ObjectDataSource -Steuerelement ruft einen bestimmten Mitarbeiterdaten Satz durch GetEmployee Aufrufen der- EmployeeLogic Methode der-Klasse ab.The ObjectDataSource control retrieves a specific employee record by calling the GetEmployee method of the EmployeeLogic class. Die GetEmployee -Methode erfordert einen Employee ID-Parameter.The GetEmployee method requires an employee ID parameter. Das ObjectDataSource -Steuerelement QueryStringParameter verwendet in der SelectParameters -Auflistung ein-Objekt, um GetEmployee in diesem Beispiel eine ID an die-Methode zu übergeben.The ObjectDataSource control uses a QueryStringParameter object in its SelectParameters collection to pass an ID to the GetEmployee method in this example.

Die Beispiel Implementierung EmployeeLogic der-Klasse und der GetEmployee -Methode finden Sie in der ObjectDataSource Übersicht über die-Klasse.To view the example implementation of the EmployeeLogic class and the GetEmployee method, see the ObjectDataSource class overview.

<%@ 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 null , der-Wert jedoch ist Parameter oder nicht aufgelöst werden kann, wenn das Objekt ausgewertet wird.The DefaultValue property is used in scenarios where the parameter is bound to a value, but the value is null or cannot be resolved when the Parameter object is evaluated.

Wenn die DefaultValue -Eigenschaft des-Parameters geändert wird OnParameterChanged , wird die-Methode aufgerufen.If the DefaultValue property of the parameter is changed, the OnParameterChanged method is called.

Gilt für: