Parameter.Direction プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Parameter.Direction プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property Direction As
 ParameterDirection

Visual Basic (使用法)

Dim instance As Parameter
Dim value As ParameterDirection

value = instance.Direction

instance.Direction = value

public ParameterDirection Direction { get;
 set; }

C++

public:
property ParameterDirection Direction {
    ParameterDirection get ();
    void set (ParameterDirection value);
}

/** @property */
public ParameterDirection get_Direction ()

/** @property */
public void set_Direction (ParameterDirection
 value)

JScript

public function get Direction
 () : ParameterDirection

public function set Direction
 (value : ParameterDirection)

プロパティ値
ParameterDirection 値の 1 つ。既定では Direction は Input に設定されます。

解説

Direction プロパティは、Parameter クラスで現在使用されていません。このプロパティは、今後使用するために予約されています。

Direction プロパティは、Parameter インスタンスのバインド先の値と Parameter オブジェクト自体の間でのデータフローの方向を示します。Direction プロパティの既定値 Input は、データフローが常に一方向 (Parameter オブジェクトのバインド先の値から Parameter オブジェクトへ) の場合の最も一般的なシナリオを示します。基になる値への変更は、Parameter オブジェクトによってリフレクションされますが、Parameter オブジェクトへの変更は、基になるデータによってリフレクションされません。出力パラメータを使用する場合は、Direction プロパティを InputOutput または Output に設定できます。また、ストアドプロシージャからの戻り値を使用する場合には、ReturnValue に設定できます。

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

使用例

Parameter オブジェクトをストアドプロシージャの出力パラメータおよび戻り値パラメータとして使用する場合に、このオブジェクトの DefaultValue、Type、Direction の各プロパティを設定する方法を次のコード例に示します。このコード例は SqlDataSourceStatusEventArgs クラスの概要で取り上げているコード例の一部分です。

Visual Basic

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