Parameter.Direction Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Určuje, zda Parameter se objekt používá k vytvoření vazby hodnoty k ovládacímu prvku, nebo lze použít ke změně hodnoty.

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

Hodnota vlastnosti

ParameterDirection

Jedna z ParameterDirection hodnot. Direction je ve výchozím nastavení nastavená na Input hodnotu.

Příklady

Následující příklad kódu ukazuje, jak nastavit DefaultValue, Typea Direction vlastnosti Parameter objektů při jejich použití jako výstupní parametry a vrátit parametry hodnoty s uloženou procedurou. Tento příklad kódu je součástí většího příkladu poskytnutého pro SqlDataSourceStatusEventArgs přehled třídy.

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

Poznámky

Vlastnost Direction není aktuálně používána Parameter třídou a je vyhrazena pro budoucí použití.

Vlastnost Direction popisuje směr toku dat mezi hodnotou, ke které Parameter je instance svázána, a samotným objektem Parameter . Výchozí hodnota vlastnosti Direction , popisuje nejběžnější scénář, Inputkdy tok dat je vždy v jednom směru: z hodnoty, ke které Parameter je objekt vázán na Parameter objekt. Všechny změny provedené v podkladové hodnotě se projeví objektem Parameter , ale všechny změny objektu Parameter se neprojeví podkladovými daty. Vlastnost můžete nastavit Direction na InputOutput nebo Output při práci s výstupními parametry nebo ReturnValue při práci s návratovou hodnotou z uložené procedury.

Direction Pokud je vlastnost parametru změněna, OnParameterChanged volá se metoda.