Compartilhar via

SessionParameter Classe

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Associa o valor de uma variável de sessão a um objeto de parâmetro.

public ref class SessionParameter : System::Web::UI::WebControls::Parameter
public class SessionParameter : System.Web.UI.WebControls.Parameter
type SessionParameter = class
    inherit Parameter
Public Class SessionParameter
Inherits Parameter
Herança
Object
Parameter
SessionParameter

Exemplos

O exemplo a seguir mostra como usar um SessionParameter objeto. O exemplo pressupõe que outra página tenha armazenado um valor de ID do funcionário em uma variável de sessão chamada empid. A página de exemplo usa a empid variável de sessão na Where cláusula de uma consulta e exibe o resultado da consulta em um GridView controle. Como a DefaultValue propriedade do SessionParameter objeto é definida como 5, os dados do registro que tem o employeeID valor 5 ainda serão exibidos se nenhuma variável de sessão nomeada empid for definida antes de você executar o exemplo.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <p>Show My Orders:</p>

      <asp:SqlDataSource
          id="OdbcDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=MyOdbcDsn;"
          SelectCommand="SELECT OrderId, CustomerId, OrderDate
                         FROM Orders
                         WHERE EmployeeID = ?
                         ORDER BY CustomerId ASC;">
          <SelectParameters>
              <asp:SessionParameter
                Name="empid"
                SessionField="empid"
                DefaultValue="5" />
          </SelectParameters>
      </asp:SqlDataSource>

      <p>
      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="OdbcDataSource1" />
      </p>
    </form>
  </body>
</html>

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <p>Show My Orders:</p>

      <asp:SqlDataSource
          id="OdbcDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=MyOdbcDsn;"
          SelectCommand="SELECT OrderId, CustomerId, OrderDate 
                         FROM Orders 
                         WHERE EmployeeID = ? 
                         ORDER BY CustomerId ASC;">
          <SelectParameters>
              <asp:SessionParameter
                Name="empid"
                SessionField="empid"
                DefaultValue="5" />
          </SelectParameters>
      </asp:SqlDataSource>

      <p>
      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="OdbcDataSource1" />
      </p>
    </form>
  </body>
</html>

Comentários

Um SessionParameter objeto normalmente é usado para incluir o valor de uma HttpSessionState variável na Where cláusula de uma consulta de banco de dados. A SessionField propriedade identifica a variável de sessão da qual o SessionParameter valor é recuperado.

Observação

Controles que associam dados a um parâmetro usando um SessionParameter objeto podem gerar uma exceção se a variável de sessão especificada não estiver definida. Para evitar esse erro (quando apropriado), defina a DefaultValue propriedade.

Construtores

Nome Description
SessionParameter()

Inicializa uma nova instância sem nome da SessionParameter classe.
SessionParameter(SessionParameter)

Inicializa uma nova instância da SessionParameter classe com os valores da instância especificados pelo original parâmetro.
SessionParameter(String, DbType, String)

Inicializa uma nova instância da SessionParameter classe usando o nome e o tipo especificados e associando o parâmetro ao par de nome/valor de estado de sessão especificado. Esse construtor é para tipos de banco de dados.
SessionParameter(String, String)

Inicializa uma nova instância nomeada da SessionParameter classe, usando a cadeia de caracteres especificada para identificar a qual par de nome/valor de estado de sessão se associar.
SessionParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe, usando a SessionParameter cadeia de caracteres especificada para identificar a qual par de nome/valor de estado de sessão associar.

Propriedades

Nome Description
ConvertEmptyStringToNull

Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está associado deve ser convertido null se for Empty.

(Herdado de Parameter)
DbType

Obtém ou define o tipo de banco de dados do parâmetro.

(Herdado de Parameter)
DefaultValue

Especifica um valor padrão para o parâmetro, caso o valor que o parâmetro esteja associado seja não inicializado quando o Evaluate(HttpContext, Control) método for chamado.

(Herdado de Parameter)
Direction

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

(Herdado de Parameter)
IsTrackingViewState

Obtém um valor que indica se o Parameter objeto está salvando alterações em seu estado de exibição.

(Herdado de Parameter)
Name

Obtém ou define o nome do parâmetro.

(Herdado de Parameter)
SessionField

Obtém ou define o nome da variável de sessão à qual o parâmetro se associa.
Size

Obtém ou define o tamanho do parâmetro.

(Herdado de Parameter)
Type

Obtém ou define o tipo do parâmetro.

(Herdado de Parameter)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um Parameter objeto em várias solicitações para a mesma página.

(Herdado de Parameter)

Métodos

Nome Description
Clone()

Retorna uma duplicata da instância atual SessionParameter .
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Evaluate(HttpContext, Control)

Atualiza e retorna o valor do SessionParameter objeto.
GetDatabaseType()

Obtém o DbType valor equivalente ao tipo CLR da instância atual Parameter .

(Herdado de Parameter)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados.

(Herdado de Parameter)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnParameterChanged()

Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto.

(Herdado de Parameter)
SaveViewState()

Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor.

(Herdado de Parameter)
SetDirty()

Marca o Parameter objeto para que seu estado seja registrado no estado de exibição.

(Herdado de Parameter)
ToString()

Converte o valor dessa instância em sua representação de cadeia de caracteres equivalente.

(Herdado de Parameter)
TrackViewState()

Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página.

(Herdado de Parameter)

Implantações explícitas de interface

Nome Description
ICloneable.Clone()

Retorna uma duplicata da instância atual Parameter .

(Herdado de Parameter)
IStateManager.IsTrackingViewState

Obtém um valor que indica se o Parameter objeto está salvando alterações em seu estado de exibição.

(Herdado de Parameter)
IStateManager.LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados.

(Herdado de Parameter)
IStateManager.SaveViewState()

Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor.

(Herdado de Parameter)
IStateManager.TrackViewState()

Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página.

(Herdado de Parameter)

Aplica-se a

Confira também