Compartilhar via


Parameter.Direction Propriedade

Definição

Indica se o objeto Parameter é usado para associar um valor a um controle ou o controle pode ser usado para alterar o valor.

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

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

Exemplos

O exemplo de código a seguir demonstra como definir as DefaultValuepropriedades , Typee Direction de Parameter objetos ao usá-los como parâmetros de saída e retornar parâmetros de valor com um procedimento armazenado. Este exemplo de código faz parte de um exemplo maior fornecido para a visão geral da SqlDataSourceStatusEventArgs 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>

Comentários

No Direction momento, a propriedade não é usada pela Parameter classe e é reservada para uso futuro.

A Direction propriedade descreve a direção do fluxo de dados entre o valor ao qual uma Parameter instância está associada e o Parameter próprio objeto. O valor padrão da Direction propriedade , Inputdescreve o cenário mais comum em que o fluxo de dados está sempre em uma direção: do valor ao qual o Parameter objeto está associado ao Parameter objeto. Todas as alterações feitas no valor subjacente são refletidas pelo Parameter objeto , mas quaisquer alterações no Parameter objeto não são refletidas pelos dados subjacentes. Você pode definir a Direction propriedade como InputOutput ou Output ao trabalhar com parâmetros de saída ou ReturnValue ao trabalhar com um valor retornado de um procedimento armazenado.

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

Aplica-se a