Parameter.DefaultValue Propriété

Définition

Spécifie une valeur par défaut pour le paramètre, à condition que la valeur à laquelle le paramètre est lié à ne soit pas initialisée lorsque la méthode Evaluate(HttpContext, Control) est appelée.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

Valeur de propriété

Chaîne qui sert de valeur par défaut pour Parameter lorsque la valeur à laquelle elle est liée ne peut pas être résolue ou n'est pas initialisée.A string that serves as a default value for the Parameter when the value it is bound to cannot be resolved or is uninitialized.

Exemples

L’exemple de code suivant montre comment récupérer un seul enregistrement de données à ObjectDataSource l’aide d’un contrôle et DetailsView l’afficher dans un contrôle.The following code example demonstrates how to retrieve a single data record using an ObjectDataSource control and display it in a DetailsView control. Le ObjectDataSource contrôle récupère un enregistrement d’employé spécifique en appelant la GetEmployee méthode de la EmployeeLogic classe.The ObjectDataSource control retrieves a specific employee record by calling the GetEmployee method of the EmployeeLogic class. La GetEmployee méthode requiert un paramètre ID d’employé.The GetEmployee method requires an employee ID parameter. Le ObjectDataSource contrôle utilise un QueryStringParameter objet dans sa SelectParameters collection pour passer un ID à la GetEmployee méthode dans cet exemple.The ObjectDataSource control uses a QueryStringParameter object in its SelectParameters collection to pass an ID to the GetEmployee method in this example.

Pour afficher l’exemple d’implémentation de EmployeeLogic la classe GetEmployee et de la méthode, ObjectDataSource consultez la vue d’ensemble de la classe.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>

Remarques

La DefaultValue propriété est utilisée dans les scénarios où le paramètre est lié à une valeur, mais la valeur null est ou ne peut pas être Parameter résolue lors de l’évaluation de l’objet.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.

Si la DefaultValue propriété du paramètre est modifiée, la OnParameterChanged méthode est appelée.If the DefaultValue property of the parameter is changed, the OnParameterChanged method is called.

S’applique à