Parameter.Direction Właściwość

Definicja

Wskazuje, czy Parameter obiekt jest używany do powiązania wartości z kontrolką, czy kontrolki można użyć do zmiany wartości.

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

Wartość właściwości

ParameterDirection

Jedna z ParameterDirection wartości. Direction jest domyślnie ustawiona na Input wartość .

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić DefaultValuewłaściwości Parameter obiektów , Typei Direction podczas używania ich jako parametrów wyjściowych i zwracać parametry wartości z procedurą składowaną. Ten przykład kodu jest częścią większego przykładu podanego SqlDataSourceStatusEventArgs na potrzeby przeglądu klasy.

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

Uwagi

Właściwość Direction nie jest obecnie używana przez klasę Parameter i jest zarezerwowana do użycia w przyszłości.

Właściwość Direction opisuje kierunek przepływu danych między wartością powiązaną z wystąpieniem Parameter i samym obiektem Parameter . Wartość domyślna właściwości Direction , opisuje najbardziej typowy scenariusz, Inputw którym przepływ danych jest zawsze w jednym kierunku: od wartości, do której Parameter obiekt jest powiązany z obiektem Parameter . Wszelkie zmiany wprowadzone w wartości bazowej są odzwierciedlane przez Parameter obiekt, ale wszelkie zmiany Parameter w obiekcie nie są odzwierciedlane przez dane bazowe. Właściwość można ustawić Direction na InputOutput lub Output podczas pracy z parametrami wyjściowymi lub ReturnValue podczas pracy z wartością zwracaną z procedury składowanej.

Direction Jeśli właściwość parametru zostanie zmieniona, metoda jest wywoływanaOnParameterChanged.

Dotyczy