Parameter.Direction Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Indica se l'oggetto Parameter viene utilizzato per associare un valore a un controllo o se il controllo può essere utilizzato per modificare il valore.

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

Valore della proprietà

ParameterDirection

Uno dei ParameterDirection valori. Direction è impostato su Input per impostazione predefinita.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare le DefaultValueproprietà , Typee Direction degli oggetti quando vengono usati come parametri di Parameter output e parametri di valore restituiti con una stored procedure. Questo esempio di codice fa parte di un esempio più ampio fornito per la panoramica della 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>

Commenti

La Direction proprietà non è attualmente utilizzata dalla Parameter classe ed è riservata per uso futuro.

La Direction proprietà descrive la direzione del flusso di dati tra il valore a cui è associata un'istanza Parameter e l'oggetto Parameter stesso. Il valore predefinito per la Direction proprietà , Input, descrive lo scenario più comune in cui il flusso di dati è sempre in una direzione: dal valore a cui è associato l'oggetto ParameterParameter . Tutte le modifiche apportate al valore sottostante vengono riflesse dall'oggetto Parameter , ma tutte le modifiche apportate all'oggetto Parameter non vengono riflesse dai dati sottostanti. È possibile impostare la Direction proprietà su InputOutput o Output quando si utilizzano parametri di output o ReturnValue quando si utilizza un valore restituito da una stored procedure.

Se la Direction proprietà del parametro viene modificata, viene chiamato il OnParameterChanged metodo .