SessionParameter Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří vazbu hodnoty proměnné relace na objekt parametru.

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

Dědičnost: Object

Parameter
SessionParameter

Příklady

Následující příklad ukazuje, jak použít SessionParameter objekt. Příklad předpokládá, že jiná stránka uložila hodnotu ID zaměstnance v proměnné relace s názvem empid. Příklad stránky používá proměnnou empid relace v Where klauzuli dotazu a zobrazí výsledek dotazu v ovládacím GridView prvku. Vzhledem k tomu, že DefaultValue vlastnost objektu SessionParameter je nastavena na hodnotu 5, data záznamu, který má employeeID hodnotu 5, se budou stále zobrazovat, pokud před spuštěním příkladu není nastavena žádná proměnná empid relace.

<%@ 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>

Poznámky

Objekt SessionParameter se obvykle používá k zahrnutí hodnoty HttpSessionState proměnné do Where klauzule databázového dotazu. Vlastnost SessionField identifikuje proměnnou relace, ze které načte SessionParameter hodnotu.

Poznámka:

Ovládací prvky, které sváže data s parametrem pomocí objektu SessionParameter , mohou vyvolat výjimku, pokud zadaná proměnná relace není nastavena. Chcete-li se této chybě vyhnout (pokud je to vhodné), nastavte DefaultValue vlastnost.

Konstruktory

Name	Description
SessionParameter()	Inicializuje novou nepojmenovanou instanci SessionParameter třídy.
SessionParameter(SessionParameter)	Inicializuje novou instanci SessionParameter třídy s hodnotami instance určené parametrem `original` .
SessionParameter(String, DbType, String)	Inicializuje novou instanci třídy pomocí zadaného SessionParameter názvu a typu a vytvoří vazbu parametru na zadaný pár název/hodnota stavu relace. Tento konstruktor je určený pro typy databází.
SessionParameter(String, String)	Inicializuje novou pojmenovanou instanci SessionParameter třídy pomocí zadaného řetězce k identifikaci dvojice název/hodnota stavu relace, ke které se má vytvořit vazba.
SessionParameter(String, TypeCode, String)	Inicializuje novou pojmenovanou a silně typovou instanci SessionParameter třídy pomocí zadaného řetězce k identifikaci páru název/hodnota relace, ke které se má vytvořit vazba.

Vlastnosti

Name	Description
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda hodnota, na kterou Parameter je objekt vázán, by měla být převedena na `null` , pokud je Empty. (Zděděno od Parameter)
DbType	Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter)
DefaultValue	Určuje výchozí hodnotu parametru, pokud má být parametr vázán na neinicializaci při Evaluate(HttpContext, Control) zavolání metody. (Zděděno od Parameter)
Direction	Určuje, zda Parameter se objekt používá k vytvoření vazby hodnoty k ovládacímu prvku, nebo lze použít ke změně hodnoty. (Zděděno od Parameter)
IsTrackingViewState	Získá hodnotu určující, zda Parameter objekt ukládá změny do jeho stavu zobrazení. (Zděděno od Parameter)
Name	Získá nebo nastaví název parametru. (Zděděno od Parameter)
SessionField	Získá nebo nastaví název proměnné relace, ke které parametr vytvoří vazbu.
Size	Získá nebo nastaví velikost parametru. (Zděděno od Parameter)
Type	Získá nebo nastaví typ parametru. (Zděděno od Parameter)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu Parameter napříč více požadavky na stejnou stránku. (Zděděno od Parameter)

Metody

Name	Description
Clone()	Vrátí duplikát aktuální SessionParameter instance.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Evaluate(HttpContext, Control)	Aktualizuje a vrátí hodnotu objektu SessionParameter .
GetDatabaseType()	DbType Získá hodnotu, která je ekvivalentní typu CLR aktuální Parameter instance. (Zděděno od Parameter)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Volá metodu ParameterCollection kolekce, která obsahuje Parameter objekt. (Zděděno od Parameter)
SaveViewState()	Uloží změny do stavu zobrazení objektu Parameter od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
SetDirty()	Parameter Označí objekt tak, aby byl jeho stav zaznamenán ve stavu zobrazení. (Zděděno od Parameter)
ToString()	Převede hodnotu této instance na ekvivalentní řetězcové vyjádření. (Zděděno od Parameter)
TrackViewState()	Způsobí, že Parameter objekt bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do objektu ViewState ovládacího prvku a zachovat napříč požadavky na stejnou stránku. (Zděděno od Parameter)

Explicitní implementace rozhraní

Name	Description
ICloneable.Clone()	Vrátí duplikát aktuální Parameter instance. (Zděděno od Parameter)
IStateManager.IsTrackingViewState	Získá hodnotu určující, zda Parameter objekt ukládá změny do jeho stavu zobrazení. (Zděděno od Parameter)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od Parameter)
IStateManager.SaveViewState()	Uloží změny do stavu zobrazení objektu Parameter od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter)
IStateManager.TrackViewState()	Způsobí, že Parameter objekt bude sledovat změny jeho stavu zobrazení, aby je bylo možné uložit do objektu ViewState ovládacího prvku a zachovat napříč požadavky na stejnou stránku. (Zděděno od Parameter)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?