Parameter.Direction Propriété

Définition

Indique si l'objet Parameter est utilisé pour lier une valeur à un contrôle ou si le contrôle peut être utilisé pour modifier la valeur.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

public:
 property System::Data::ParameterDirection Direction { System::Data::ParameterDirection get(); void set(System::Data::ParameterDirection value); };
public System.Data.ParameterDirection Direction { get; set; }
member this.Direction : System.Data.ParameterDirection with get, set
Public Property Direction As ParameterDirection

Valeur de propriété

Une des valeurs de ParameterDirection.One of the ParameterDirection values. Direction a la valeur Input par défaut.Direction is set to Input by default.

Exemples

L’exemple de code suivant montre comment définir les DefaultValuepropriétés Type, et Direction des objets Parameter lorsque vous les utilisez en tant que paramètres de sortie et paramètres de valeur de retour avec une procédure stockée.The following code example demonstrates how to set the DefaultValue, Type, and Direction properties of Parameter objects when using them as output parameters and return value parameters with a stored procedure. Cet exemple de code fait partie d’un exemple plus complet fourni SqlDataSourceStatusEventArgs pour la vue d’ensemble de la classe.This code example is part of a larger example provided for the SqlDataSourceStatusEventArgs class overview.

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId" />
      <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>
<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId" />
      <asp:parameter name="total" type="Int32" direction="Output" defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue" defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>

Remarques

La Direction propriété n’est pas utilisée actuellement par Parameter la classe et est réservée à une utilisation ultérieure.The Direction property is currently not used by the Parameter class and is reserved for future use.

La Direction propriété décrit la direction du workflow de données entre la valeur à laquelle une Parameter instance est liée et l' Parameter objet lui-même.The Direction property describes the direction of the flow of data between the value that a Parameter instance is bound to and the Parameter object itself. La valeur par défaut de Direction la propriété Input,, décrit le scénario le plus courant dans lequel le workflow de données est toujours dans une direction : à partir de Parameter la valeur à laquelle l' Parameter objet est lié à l’objet.The default value for the Direction property, Input, describes the most common scenario where the flow of data is always in one direction: from the value to which the Parameter object is bound to the Parameter object. Toutes les modifications apportées à la valeur sous- Parameter jacente sont reflétées par l’objet Parameter , mais les modifications apportées à l’objet ne sont pas reflétées par les données sous-jacentes.Any changes made to the underlying value are reflected by the Parameter object, but any changes to the Parameter object are not reflected by the underlying data. Vous pouvez affecter à Direction InputOutput la propriété la Output valeur ou lorsque vous utilisez des paramètres ReturnValue de sortie, ou lorsque vous utilisez une valeur de retour d’une procédure stockée.You can set the Direction property to InputOutput or Output when working with output parameters, or ReturnValue when working with a return value from a stored procedure.

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

S’applique à