Parameter.Direction Propriedade

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

Valor de Propriedade

Um dos ParameterDirection valores. Direction é definido como Input por padrão.

Exemplos

O exemplo de código seguinte demonstra como definir os DefaultValue, Type, e Direction propriedades dos Parameter objetos ao usá-los como parâmetros de saída e parâmetros de valor de retorno com um procedimento armazenado. Este exemplo de código faz parte de um exemplo maior fornecido para a SqlDataSourceStatusEventArgs visão geral da classe.

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

Observações

A Direction propriedade atualmente não é utilizada pela Parameter turma e está reservada para uso futuro.

A Direction propriedade descreve a direção do fluxo de dados entre o valor a que uma Parameter instância está vinculada e o Parameter próprio objeto. O valor padrão da Direction propriedade, Input, descreve o cenário mais comum em que o fluxo de dados é sempre numa direção: do valor ao qual o Parameter objeto está ligado ao Parameter objeto. Quaisquer alterações feitas ao valor subjacente são refletidas pelo Parameter objeto, mas quaisquer alterações ao Parameter objeto não são refletidas pelos dados subjacentes. Pode definir a Direction propriedade para InputOutput ou Output ao trabalhar com parâmetros de saída, ou ReturnValue ao trabalhar com um valor de retorno de um procedimento armazenado.

Se a Direction propriedade do parâmetro for alterada, o OnParameterChanged método é chamado.