SessionParameter Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Vincula o valor de uma variável de sessão a um objeto 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 seguinte mostra como usar um SessionParameter objeto. O exemplo assume que outra página armazenou um valor de ID de empregado numa variável de sessão chamada empid. A página de exemplo utiliza a empid variável de sessão na Where cláusula de uma consulta e apresenta o resultado da consulta num GridView controlo. Como a DefaultValue propriedade do SessionParameter objeto está definida para 5, os dados do registo com employeeID valor 5 continuarão a ser exibidos se nenhuma variável de sessão nomeada empid for definida antes de executares 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>

Observações

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

Note

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

Construtores

Name	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 tipo especificados, e ligando o parâmetro ao par nome/valor de estado da sessão especificado. Este construtor destina-se a tipos de bases de dados.
SessionParameter(String, String)	Inicializa uma nova instância nomeada da SessionParameter classe, usando a string especificada para identificar a que par de estado de sessão nome/valor deve ser associado.
SessionParameter(String, TypeCode, String)	Inicializa uma nova instância nomeada e fortemente tipada da SessionParameter classe, usando a cadeia especificada para identificar a que par de estado de sessão/valor deve ser associado.

Propriedades

Name	Description
ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está ligado deve ser convertido se `null` for Empty. (Herdado de Parameter)
DbType	Obtém ou define o tipo de base de dados do parâmetro. (Herdado de Parameter)
DefaultValue	Especifica um valor por defeito para o parâmetro, caso o valor que o parâmetro está vinculado a ser 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 controlo, ou se o controlo pode ser usado para alterar o valor. (Herdado de Parameter)
IsTrackingViewState	Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualizaçã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 liga.
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ção de estado que permite guardar e restaurar o estado de visualização de um Parameter objeto através de múltiplos pedidos para a mesma página. (Herdado de Parameter)

Métodos

Name	Description
Clone()	Devolve um duplicado da instância atual SessionParameter .
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Evaluate(HttpContext, Control)	Atualiza e devolve 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 função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de Parameter)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnParameterChanged()	Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto. (Herdado de Parameter)
SaveViewState()	Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de Parameter)
SetDirty()	Marca o Parameter objeto para que o seu estado fique registado no estado de visualização. (Herdado de Parameter)
ToString()	Converte o valor desta instância para a sua representação equivalente da cadeia. (Herdado de Parameter)
TrackViewState()	Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página. (Herdado de Parameter)

Implementações de Interface Explícita

Name	Description
ICloneable.Clone()	Devolve um duplicado da instância atual Parameter . (Herdado de Parameter)
IStateManager.IsTrackingViewState	Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização. (Herdado de Parameter)
IStateManager.LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de Parameter)
IStateManager.SaveViewState()	Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de Parameter)
IStateManager.TrackViewState()	Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página. (Herdado de Parameter)

Aplica-se a

Ver também

Comentários

Esta página foi útil?