Parameter.Direction 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

表示此 Parameter 物件是否用來將值繫結至控制項，或是這個控制項是否可用來變更該值。

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

屬性值

ParameterDirection

其中一個 ParameterDirection 值。 根據預設，Direction 是設為 Input。

範例

下列程式碼範例示範如何在使用 物件做為輸出參數時，設定 DefaultValue 物件的 、 Type 和 Direction 屬性 Parameter ，以及搭配預存程式傳回值參數。 此程式碼範例是類別概觀所提供較大範例的 SqlDataSourceStatusEventArgs 一部分。

<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>

備註

屬性 Direction 目前不會由 Parameter 類別使用，並保留供日後使用。

屬性 Direction 描述實例所系結值 Parameter 與 Parameter 物件本身之間的資料流程方向。 屬性 Input 的 Direction 預設值描述最常見的案例，其中資料流程一律是單向：從物件系結至 ParameterParameter 物件的值。 對基礎值所做的任何變更會由 Parameter 物件反映，但對 物件所做的任何變更 Parameter 都不會由基礎資料反映。 您可以在使用輸出參數時，或在處理預存程式的傳回值時，將 屬性設定 Direction 為 InputOutputOutput 或 ReturnValue 。

Direction如果參數的 屬性已變更，則會 OnParameterChanged 呼叫 方法。