Parameter.Direction Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Gibt an, ob das Parameter Objekt verwendet wird, um einen Wert an ein Steuerelement zu binden, oder das Steuerelement kann verwendet werden, um den Wert zu ändern.

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 die Eigenschaften von Objekten festgelegt werden, wenn sie als Ausgabeparameter und Rückgabewertparameter mit einer gespeicherten Prozedur verwendet werden.The following code example demonstrates how to set the DefaultValue, Type, , and Direction properties of Parameter objects when using them as output parameters and return value parameters with a stored procedure. 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 dem Parameter Objekt selbst. Der Standardwert für die Direction Eigenschaft Input, beschreibt das am häufigsten verwendete Szenario, in dem der Datenfluss immer in einer Richtung liegt: vom Wert, an den das Parameter Objekt an das Parameter Objekt gebunden ist. Alle Änderungen, die an dem zugrunde liegenden Wert vorgenommen wurden, werden vom Parameter Objekt widerzuspiegeln, aber alle Änderungen am Parameter Objekt werden nicht von den zugrunde liegenden Daten widerzuspiegeln. Sie können die Direction Eigenschaft InputOutput auf oder beim Arbeiten mit Ausgabeparametern oder OutputReturnValue beim Arbeiten mit einem Rückgabewert aus einer gespeicherten Prozedur festlegen.

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