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 値のいずれか 1 つ。 既定では、Direction は Input に設定されています。

例

次のコード例では、オブジェクトを出力パラメーターとして使用する場合に 、Type、および プロパティParameterを設定DefaultValueしDirection、ストアド プロシージャを使用して値パラメーターを返す方法を示します。 このコード例は、クラスの概要に関して提供されるより大きな例の 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 表します。 プロパティの Direction 既定値 である は、 Inputデータフローが常に一方向 (オブジェクトにバインドされている Parameter 値から) にある最も一般的なシナリオを Parameter 表します。 基になる値に加えられた変更は オブジェクトによって Parameter 反映されますが、オブジェクトに対する Parameter 変更は基になるデータによって反映されません。 プロパティは、出力パラメーターをDirectionInputOutput操作するとき、Outputまたはストアド プロシージャからの戻り値を操作する場合に、 または ReturnValue に設定できます。

パラメーターの Direction プロパティを変更すると、 メソッドが OnParameterChanged 呼び出されます。