SessionParameter Třída
Definice
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
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 do proměnné relace s názvem empid
. Stránka s ukázkou empid
používá proměnnou relace v klauzuli Where
dotazu a zobrazí výsledek dotazu v ovládacím GridView prvku. DefaultValue Vzhledem k tomu, že vlastnost objektu SessionParameter je nastavena na 5, data záznamu, který má employeeID
hodnotu 5, budou stále zobrazena, pokud není nastavena žádná proměnná relace s názvem empid
před spuštěním příkladu.
<%@ 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 , můžou vyvolat výjimku, pokud není nastavená zadaná proměnná relace. Chcete-li se této chybě vyhnout (pokud je to vhodné), nastavte DefaultValue vlastnost.
Konstruktory
SessionParameter() |
Inicializuje novou nepojmenovanou instanci SessionParameter třídy. |
SessionParameter(SessionParameter) |
Inicializuje novou instanci SessionParameter třídy s hodnotami instance určené parametrem |
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 databázové typy. |
SessionParameter(String, String) |
Inicializuje novou pojmenovanou instanci třídy pomocí zadaného SessionParameter řetězce k identifikaci, ke kterému páru název/hodnota stavu relace se má vytvořit vazba. |
SessionParameter(String, TypeCode, String) |
Inicializuje novou pojmenovanou instanci třídy a silného typu pomocí zadaného SessionParameter řetězce k identifikaci, ke kterému páru název/hodnota stavu relace se má svázat. |
Vlastnosti
ConvertEmptyStringToNull |
Získá nebo nastaví hodnotu určující, zda má být hodnota, na kterou Parameter je objekt vázán, převedena, |
DbType |
Získá nebo nastaví typ databáze parametru. (Zděděno od Parameter) |
DefaultValue |
Určuje výchozí hodnotu parametru, pokud hodnota, kterou je parametr vázán být neinicializován 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 na ovládací prvek, nebo zda lze ovládací prvek použít ke změně hodnoty. (Zděděno od Parameter) |
IsTrackingViewState |
Získá hodnotu označující, zda Parameter objekt ukládá změny do svého 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, se kterou 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 více požadavků na stejnou stránku. (Zděděno od Parameter) |
Metody
Clone() |
Vrátí duplikát aktuální SessionParameter instance. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
Evaluate(HttpContext, Control) |
Aktualizace a vrátí hodnotu objektuSessionParameter. |
GetDatabaseType() |
DbType Získá hodnotu, která je ekvivalentní k CLR typ aktuální Parameter instance. (Zděděno od Parameter) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Získá aktuální Type 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 Objectsouboru . (Zděděno od Object) |
OnParameterChanged() |
Zavolá metodu OnParametersChanged(EventArgs)ParameterCollection kolekce, která obsahuje Parameter objekt. (Zděděno od Parameter) |
SaveViewState() |
Uloží změny stavu zobrazení objektu Parameter od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter) |
SetDirty() |
Označí Parameter objekt tak, aby jeho stav byl zaznamenán ve stavu zobrazení. (Zděděno od Parameter) |
ToString() |
Převede hodnotu této instance na její odpovídající řetězcovou reprezentaci. (Zděděno od Parameter) |
TrackViewState() |
Způsobí, že Parameter objekt sleduje změny stavu zobrazení, aby je bylo možné uložit do objektu ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od Parameter) |
Explicitní implementace rozhraní
ICloneable.Clone() |
Vrátí duplikát aktuální Parameter instance. (Zděděno od Parameter) |
IStateManager.IsTrackingViewState |
Získá hodnotu označující, zda Parameter objekt ukládá změny do svého 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 stavu zobrazení objektu Parameter od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Parameter) |
IStateManager.TrackViewState() |
Způsobí, že Parameter objekt sleduje změny stavu zobrazení, aby je bylo možné uložit do objektu ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku. (Zděděno od Parameter) |
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro