Parameter.Direction Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann.

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

Eigenschaftswert

ParameterDirection

Einer der ParameterDirection-Werte. Direction ist standardmäßig auf Input festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DefaultValueTypeEigenschaften und Direction Eigenschaften von Parameter Objekten beim Verwenden als Ausgabeparameter und Rückgabewertparameter mit einer gespeicherten Prozedur festlegen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SqlDataSourceStatusEventArgs Klassenübersicht bereitgestellt wird.

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

Hinweise

Die Direction Eigenschaft wird derzeit nicht von der Parameter Klasse verwendet und ist für die zukünftige Verwendung reserviert.

Die Direction Eigenschaft beschreibt die Richtung des Datenflusses zwischen dem Wert, an den eine Parameter Instanz gebunden ist, und das Parameter Objekt selbst. Der Standardwert für die Direction Eigenschaft, Inputbeschreibt das am häufigsten verwendete Szenario, in dem sich der Datenfluss immer in einer Richtung befindet: vom Wert, an den das Parameter Objekt an das Parameter Objekt gebunden ist. Alle Änderungen, die an dem Parameter zugrunde liegenden Wert vorgenommen wurden, werden vom Objekt widerspiegelt, aber alle Änderungen am Parameter Objekt werden nicht von den zugrunde liegenden Daten wiedergegeben. Sie können die Direction Eigenschaft auf oder Output beim Arbeiten mit Ausgabeparametern oder ReturnValue beim Arbeiten mit einem Rückgabewert aus einer gespeicherten InputOutput Prozedur festlegen.

Wenn die Direction Eigenschaft des Parameters geändert wird, wird die OnParameterChanged Methode aufgerufen.