SessionParameter Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy munkamenet-változó értékét egy paraméterobjektumhoz köti.

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

Öröklődés: Object

Parameter
SessionParameter

Példák

Az alábbi példa egy objektum használatát SessionParameter mutatja be. A példa azt feltételezi, hogy egy másik lap egy alkalmazotti azonosítóértéket tárolt egy munkamenet-változóban.empid A példaoldal egy empid lekérdezés záradékában a Where munkamenet változóját használja, és egy vezérlőben GridView jeleníti meg a lekérdezés eredményét. Mivel az DefaultValue SessionParameter objektum tulajdonsága 5, az 5 értéket tartalmazó employeeID rekord adatai akkor is megjelennek, ha a példa futtatása előtt nincs megadva a munkamenet-változó neve empid .

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

Megjegyzések

Az SessionParameter objektumokat általában arra használják, hogy egy változó értékét HttpSessionState belefoglalják egy Where adatbázis-lekérdezés záradékába. A SessionField tulajdonság azonosítja azt a munkamenet-változót, amelyből a SessionParameter rendszer egy értéket kér le.

Note

Ha a megadott munkamenet-változó nincs beállítva, az objektum használatával SessionParameter adatokat egy paraméterhez kötő vezérlők kivételt jelenthetnek. A hiba elkerülése érdekében (ha szükséges) állítsa be a tulajdonságot DefaultValue .

Konstruktorok

Name	Description
SessionParameter()	Inicializálja az osztály új, meg nem nevezett példányát SessionParameter .
SessionParameter(SessionParameter)	Inicializálja az SessionParameter osztály új példányát a paraméter által `original` megadott példány értékeivel.
SessionParameter(String, DbType, String)	Inicializálja az SessionParameter osztály új példányát a megadott név és típus használatával, és a paramétert a megadott munkamenetállapot-név/érték párhoz köti. Ez a konstruktor adatbázistípusokhoz készült.
SessionParameter(String, String)	Inicializálja az SessionParameter osztály új nevesített példányát a megadott sztring használatával annak azonosításához, hogy melyik munkamenetállapot-névhez/értékpárhoz kell csatlakozni.
SessionParameter(String, TypeCode, String)	Inicializálja az SessionParameter osztály új elnevezett és erősen beírt példányát a megadott sztring használatával annak azonosításához, hogy melyik munkamenetállapot-név/érték párhoz kell csatlakozni.

Tulajdonságok

Name	Description
ConvertEmptyStringToNull	Lekéri vagy beállít egy értéket, amely jelzi, hogy az Parameter objektumhoz kötött értéket konvertálni `null` kell-e, ha igen Empty. (Öröklődés forrása Parameter)
DbType	Lekéri vagy beállítja a paraméter adatbázistípusát. (Öröklődés forrása Parameter)
DefaultValue	A paraméter alapértelmezett értékét adja meg, ha a metódus meghívásakor Evaluate(HttpContext, Control) a paraméter nem inicializálódik. (Öröklődés forrása Parameter)
Direction	Azt jelzi, hogy az Parameter objektum egy vezérlőelemhez köti-e az értéket, vagy a vezérlőelem használható az érték módosítására. (Öröklődés forrása Parameter)
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az Parameter objektum menti-e a nézetállapot módosításait. (Öröklődés forrása Parameter)
Name	Lekéri vagy beállítja a paraméter nevét. (Öröklődés forrása Parameter)
SessionField	Lekéri vagy beállítja annak a munkamenet-változónak a nevét, amelyhez a paraméter kapcsolódik.
Size	Lekéri vagy beállítja a paraméter méretét. (Öröklődés forrása Parameter)
Type	Lekéri vagy beállítja a paraméter típusát. (Öröklődés forrása Parameter)
ViewState	Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy objektum nézetállapotának mentését és visszaállítását Parameter ugyanazon lap több kérésében. (Öröklődés forrása Parameter)

Metódusok

Name	Description
Clone()	Az aktuális SessionParameter példány duplikátumát adja vissza.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Evaluate(HttpContext, Control)	Frissíti és visszaadja az SessionParameter objektum értékét.
GetDatabaseType()	Lekéri az DbType aktuális Parameter példány CLR-típusával egyenértékű értéket. (Öröklődés forrása Parameter)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása Parameter)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnParameterChanged()	Meghívja OnParametersChanged(EventArgs) az ParameterCollection objektumot tartalmazó gyűjtemény metódusátParameter. (Öröklődés forrása Parameter)
SaveViewState()	Menti az Parameter objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása Parameter)
SetDirty()	Megjelöli az Parameter objektumot, hogy az állapota megtekintési állapotban legyen rögzítve. (Öröklődés forrása Parameter)
ToString()	A példány értékét a megfelelő sztring-ábrázolásúvá alakítja. (Öröklődés forrása Parameter)
TrackViewState()	Ez azt eredményezi, hogy az Parameter objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState objektumában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása Parameter)

Explicit interfész-implementációk

Name	Description
ICloneable.Clone()	Az aktuális Parameter példány duplikátumát adja vissza. (Öröklődés forrása Parameter)
IStateManager.IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy az Parameter objektum menti-e a nézetállapot módosításait. (Öröklődés forrása Parameter)
IStateManager.LoadViewState(Object)	Visszaállítja az adatforrásnézet korábban mentett nézetállapotát. (Öröklődés forrása Parameter)
IStateManager.SaveViewState()	Menti az Parameter objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta. (Öröklődés forrása Parameter)
IStateManager.TrackViewState()	Ez azt eredményezi, hogy az Parameter objektum nyomon követi a nézetállapot változásait, hogy azok a vezérlő ViewState objektumában tárolhatók legyenek, és ugyanazon lap kérései között megmaradjanak. (Öröklődés forrása Parameter)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?