SessionParameter Classe
Definição
Associa o valor de uma variável de sessão a um objeto de parâmetro.Binds the value of a session variable to a parameter object.
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
Exemplos
O exemplo a seguir mostra como usar um SessionParameter objeto.The following example shows how to use a SessionParameter object. O exemplo supõe que outra página armazenou um valor de ID de funcionário em uma variável de sessão chamada empid .The example assumes that another page has stored an employee ID value in a session variable named 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.The example page uses the empid session variable in the Where clause of a query and displays the result of the query in a GridView control. Como a DefaultValue Propriedade do SessionParameter objeto é definida como 5, os dados para o registro que tem o employeeID valor 5 ainda serão exibidos se nenhuma variável de sessão chamada empid for definida antes de executar o exemplo.Because the DefaultValue property of the SessionParameter object is set to 5, data for the record that has the employeeID value of 5 will still be displayed if no session variable named empid is set before you run the example.
<%@ 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 SessionParameter object is typically used in order to include the value of an HttpSessionState variable in the Where clause of a database query. A SessionField propriedade identifica a variável de sessão da qual o SessionParameter recupera um valor.The SessionField property identifies the session variable from which the SessionParameter retrieves a value.
Observação
Os 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.Controls that bind data to a parameter by using a SessionParameter object might throw an exception if the specified session variable is not set. Para evitar esse erro (quando apropriado), defina a DefaultValue propriedade.To avoid this error (where appropriate), set the DefaultValue property.
Construtores
| SessionParameter() |
Inicializa uma nova instância não nomeada da classe SessionParameter.Initializes a new unnamed instance of the SessionParameter class. |
| SessionParameter(SessionParameter) |
Inicializa uma nova instância da classe SessionParameter com os valores da instância especificada pelo parâmetro |
| SessionParameter(String, DbType, String) |
Inicializa uma nova instância da classe SessionParameter usando o nome e tipo especificados e associando o parâmetro ao par nome-valor de estado de sessão especificado.Initializes a new instance of the SessionParameter class, by using the specified name and type, and binding the parameter to the specified session state name/value pair. Este construtor é para tipos de banco de dados.This constructor is for database types. |
| SessionParameter(String, String) |
Inicializa uma nova instância nomeada da classe SessionParameter, usando a cadeia de caracteres especificada para identificar a qual par nome-valor do estado de sessão se associar.Initializes a new named instance of the SessionParameter class, using the specified string to identify which session state name/value pair to bind to. |
| SessionParameter(String, TypeCode, String) |
Inicializa uma nova instância nomeada e fortemente tipada da classe SessionParameter, usando a cadeia de caracteres especificada para identificar a qual par nome-valor do estado de sessão se associar.Initializes a new named and strongly typed instance of the SessionParameter class, using the specified string to identify which session state name/value pair to bind to. |
Propriedades
| ConvertEmptyStringToNull |
Obtém ou define um valor que indica se o valor ao qual o objeto Parameter está associado deverá ser convertido em |
| DbType |
Obtém ou define o tipo de banco de dados do parâmetro.Gets or sets the database type of the parameter. (Herdado de Parameter) |
| DefaultValue |
Especifica um valor padrão para o parâmetro, caso o valor a que o parâmetro esteja associado não devesse ser inicializado quando o método Evaluate(HttpContext, Control) for chamado.Specifies a default value for the parameter, should the value that the parameter is bound to be uninitialized when the Evaluate(HttpContext, Control) method is called. (Herdado de Parameter) |
| Direction |
Indica se o objeto Parameter é usado para associar um valor a um controle ou o controle pode ser usado para alterar o valor.Indicates whether the Parameter object is used to bind a value to a control, or the control can be used to change the value. (Herdado de Parameter) |
| IsTrackingViewState |
Obtém um valor que indica se o objeto Parameter está salvando alterações no estado de exibição.Gets a value indicating whether the Parameter object is saving changes to its view state. (Herdado de Parameter) |
| Name |
Obtém ou define o nome do parâmetro.Gets or sets the name of the parameter. (Herdado de Parameter) |
| SessionField |
Obtém ou define o nome da variável de sessão à qual o parâmetro se associa.Gets or sets the name of the session variable that the parameter binds to. |
| Size |
Obtém ou define o tamanho do parâmetro.Gets or sets the size of the parameter. (Herdado de Parameter) |
| Type |
Obtém ou define o tipo do parâmetro.Gets or sets the type of the parameter. (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 objeto Parameter em várias solicitações da mesma página.Gets a dictionary of state information that allows you to save and restore the view state of a Parameter object across multiple requests for the same page. (Herdado de Parameter) |
Métodos
| Clone() |
Retorna uma duplicata da instância de SessionParameter atual.Returns a duplicate of the current SessionParameter instance. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| Evaluate(HttpContext, Control) |
Atualiza e retorna o valor do objeto SessionParameter.Updates and returns the value of the SessionParameter object. |
| GetDatabaseType() |
Obtém o valor DbType que é equivalente ao tipo CLR da instância Parameter atual.Gets the DbType value that is equivalent to the CLR type of the current Parameter instance. (Herdado de Parameter) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.Restores the data source view's previously saved view state. (Herdado de Parameter) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| OnParameterChanged() |
Chama o método OnParametersChanged(EventArgs) da coleção ParameterCollection que contém o objeto Parameter.Calls the OnParametersChanged(EventArgs) method of the ParameterCollection collection that contains the Parameter object. (Herdado de Parameter) |
| SaveViewState() |
Salva as alterações ao estado de exibição do objeto Parameter desde a hora em que a página foi postada de volta no servidor.Saves the changes to the Parameter object's view state since the time the page was posted back to the server. (Herdado de Parameter) |
| SetDirty() |
Marca o objeto Parameter de modo que seu estado seja registrado no estado de exibição.Marks the Parameter object so its state will be recorded in view state. (Herdado de Parameter) |
| ToString() |
Converte o valor dessa instância na representação da cadeia de caracteres equivalente.Converts the value of this instance to its equivalent string representation. (Herdado de Parameter) |
| TrackViewState() |
Faz com que o objeto Parameter controle as alterações a seu estado de exibição de modo que elas possam ser armazenadas no objeto ViewState do controle e persistidas entre solicitações para a mesma página.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page. (Herdado de Parameter) |
Implantações explícitas de interface
| ICloneable.Clone() |
Retorna uma duplicata da instância de Parameter atual.Returns a duplicate of the current Parameter instance. (Herdado de Parameter) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o objeto Parameter está salvando alterações no estado de exibição.Gets a value indicating whether the Parameter object is saving changes to its view state. (Herdado de Parameter) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados.Restores the data source view's previously saved view state. (Herdado de Parameter) |
| IStateManager.SaveViewState() |
Salva as alterações ao estado de exibição do objeto Parameter desde a hora em que a página foi postada de volta no servidor.Saves the changes to the Parameter object's view state since the time the page was posted back to the server. (Herdado de Parameter) |
| IStateManager.TrackViewState() |
Faz com que o objeto Parameter controle as alterações a seu estado de exibição de modo que elas possam ser armazenadas no objeto ViewState do controle e persistidas entre solicitações para a mesma página.Causes the Parameter object to track changes to its view state so they can be stored in the control's ViewState object and persisted across requests for the same page. (Herdado de Parameter) |