Parameter.Direction Parameter.Direction Parameter.Direction Parameter.Direction Property

Definition

Gibt an, ob das Parameter-Objekt zum Binden eines Werts an ein Steuerelement oder das Steuerelement zum Ändern des Werts verwendet werden kann.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value.

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

Einer der ParameterDirection-Werte.One of the ParameterDirection values. Direction ist standardmäßig auf Input festgelegt.Direction is set to Input by default.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DefaultValueEigenschaften Type, und Direction der Parameter -Objekte festgelegt werden, wenn Sie als Ausgabeparameter und Rückgabewert Parameter 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.This code example is part of a larger example provided for the SqlDataSourceStatusEventArgs class overview.

<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.The Direction property is currently not used by the Parameter class and is reserved for future use.

Die Direction -Eigenschaft beschreibt die Richtung des Datenflusses zwischen dem Wert, an den Parameter eine-Instanz gebunden ist, Parameter und dem-Objekt selbst.The Direction property describes the direction of the flow of data between the value that a Parameter instance is bound to and the Parameter object itself. Der Standardwert für die Direction - InputEigenschaft,, beschreibt das häufigste Szenario, in dem der Datenfluss immer in eine Richtung verläuft: von dem Wert, an Parameter den das-Objekt an Parameter das-Objekt gebunden ist.The default value for the Direction property, Input, describes the most common scenario where the flow of data is always in one direction: from the value to which the Parameter object is bound to the Parameter object. Alle an dem zugrunde liegenden Wert vorgenommenen Änderungen werden vom Parameter -Objekt reflektiert, aber alle Änderungen Parameter am-Objekt werden nicht durch die zugrunde liegenden Daten reflektiert.Any changes made to the underlying value are reflected by the Parameter object, but any changes to the Parameter object are not reflected by the underlying data. Sie können die Direction -Eigenschaft auf InputOutput oder Output festlegen, wenn Sie mit Ausgabeparametern ReturnValue arbeiten, oder wenn Sie mit einem Rückgabewert einer gespeicherten Prozedur arbeiten.You can set the Direction property to InputOutput or Output when working with output parameters, or ReturnValue when working with a return value from a stored procedure.

Wenn die Direction -Eigenschaft des-Parameters geändert wird OnParameterChanged , wird die-Methode aufgerufen.If the Direction property of the parameter is changed, the OnParameterChanged method is called.

Gilt für: