Parameter.Direction Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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.

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é

ParameterDirection

Une des valeurs de l'objet ParameterDirection. Direction a la valeur Input par défaut.

Exemples

L’exemple de code suivant montre comment définir les propriétés et Direction les DefaultValueTypepropriétés des objets lors de leur utilisation en tant que paramètres de Parameter sortie et retourner des paramètres de valeur avec une procédure stockée. Cet exemple de code fait partie d’un exemple plus grand fourni pour la vue d’ensemble de la SqlDataSourceStatusEventArgs classe.

<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 actuellement pas utilisée par la Parameter classe et est réservée à une utilisation ultérieure.

La Direction propriété décrit la direction du flux de données entre la valeur à laquelle une Parameter instance est liée et l’objet Parameter lui-même. La valeur par défaut de la Direction propriété, Inputdécrit le scénario le plus courant dans lequel le flux de données est toujours dans une direction : de la valeur à laquelle l’objet Parameter est lié à l’objet Parameter . Toutes les modifications apportées à la valeur sous-jacente sont reflétées par l’objet Parameter , mais toutes les modifications apportées à l’objet Parameter ne sont pas reflétées par les données sous-jacentes. Vous pouvez définir la Direction propriété InputOutput sur ou Output lors de l’utilisation des paramètres de sortie, ou ReturnValue lors de l’utilisation d’une valeur de retour à partir d’une procédure stockée.

Si la Direction propriété du paramètre est modifiée, la OnParameterChanged méthode est appelée.