Compartilhar via


Parameter.Direction Propriedade

Definição

Indica se o Parameter objeto é usado para associar um valor a um controle ou se 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 ParameterDirection valores. Direction é definido como Input por padrão.

Exemplos

O exemplo de código a seguir demonstra como definir o DefaultValue, Typee Direction as propriedades dos 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 descreve Inputo 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