SessionParameter Klass

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Binder värdet för en sessionsvariabel till ett parameterobjekt.

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
Arv
Object
Parameter
SessionParameter

Exempel

I följande exempel visas hur du använder ett SessionParameter objekt. Exemplet förutsätter att en annan sida har lagrat ett värde för medarbetar-ID i en sessionsvariabel med namnet empid. Exempelsidan använder empid sessionsvariabeln i satsen för Where en fråga och visar resultatet av frågan i en GridView kontroll. DefaultValue Eftersom egenskapen SessionParameter för objektet är inställd på 5 visas fortfarande data för posten som har employeeID värdet 5 om ingen sessionsvariabel med namnet empid anges innan du kör exemplet.

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

Kommentarer

Ett SessionParameter objekt används vanligtvis för att inkludera värdet för en HttpSessionState variabel i -satsen i Where en databasfråga. Egenskapen SessionField identifierar sessionsvariabeln som SessionParameter hämtar ett värde från.

Note

Kontroller som binder data till en parameter med hjälp av ett SessionParameter objekt kan utlösa ett undantag om den angivna sessionsvariabeln inte har angetts. Om du vill undvika det här felet (i förekommande fall) anger du egenskapen DefaultValue .

Konstruktorer

Name Description
SessionParameter()

Initierar en ny namnlös instans av SessionParameter klassen.
SessionParameter(SessionParameter)

Initierar en ny instans av SessionParameter klassen med värdena för den instans som anges av parametern original .
SessionParameter(String, DbType, String)

Initierar en ny instans av SessionParameter klassen med det angivna namnet och typen och binder parametern till det angivna sessionstillståndsnamnet/värdeparet. Den här konstruktorn är avsedd för databastyper.
SessionParameter(String, String)

Initierar en ny namngiven SessionParameter instans av klassen med hjälp av den angivna strängen för att identifiera vilket sessionstillståndsnamn/värdepar som ska bindas till.
SessionParameter(String, TypeCode, String)

Initierar en ny namngiven och starkt typinstans av klassen med hjälp av den angivna strängen SessionParameter för att identifiera vilket sessionstillståndsnamn/värdepar som ska bindas till.

Egenskaper

Name Description
ConvertEmptyStringToNull

Hämtar eller anger ett värde som anger om värdet som objektet är bundet Parameter till ska konverteras till null om det är Empty.

(Ärvd från Parameter)
DbType

Hämtar eller anger parameterns databastyp.

(Ärvd från Parameter)
DefaultValue

Anger ett standardvärde för parametern om värdet som parametern är bunden till är onitialiserat när Evaluate(HttpContext, Control) metoden anropas.

(Ärvd från Parameter)
Direction

Anger om objektet Parameter används för att binda ett värde till en kontroll eller om kontrollen kan användas för att ändra värdet.

(Ärvd från Parameter)
IsTrackingViewState

Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet.

(Ärvd från Parameter)
Name

Hämtar eller anger namnet på parametern.

(Ärvd från Parameter)
SessionField

Hämtar eller anger namnet på sessionsvariabeln som parametern binder till.
Size

Hämtar eller anger parameterns storlek.

(Ärvd från Parameter)
Type

Hämtar eller anger parametertypen.

(Ärvd från Parameter)
ViewState

Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för ett Parameter objekt över flera begäranden för samma sida.

(Ärvd från Parameter)

Metoder

Name Description
Clone()

Returnerar en dubblett av den aktuella SessionParameter instansen.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Evaluate(HttpContext, Control)

Uppdaterar och returnerar objektets SessionParameter värde.
GetDatabaseType()

Hämtar värdet DbType som motsvarar CLR-typen för den aktuella Parameter instansen.

(Ärvd från Parameter)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
LoadViewState(Object)

Återställer datakällans tidigare sparade vytillstånd.

(Ärvd från Parameter)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnParameterChanged()

Anropar metoden för OnParametersChanged(EventArgs) samlingen ParameterCollection som innehåller Parameter objektet.

(Ärvd från Parameter)
SaveViewState()

Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern.

(Ärvd från Parameter)
SetDirty()

Parameter Markerar objektet så att dess tillstånd registreras i visningstillstånd.

(Ärvd från Parameter)
ToString()

Konverterar värdet för den här instansen till motsvarande strängrepresentation.

(Ärvd från Parameter)
TrackViewState()

Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida.

(Ärvd från Parameter)

Explicita gränssnittsimplementeringar

Name Description
ICloneable.Clone()

Returnerar en dubblett av den aktuella Parameter instansen.

(Ärvd från Parameter)
IStateManager.IsTrackingViewState

Hämtar ett värde som anger om Parameter objektet sparar ändringar i visningstillståndet.

(Ärvd från Parameter)
IStateManager.LoadViewState(Object)

Återställer datakällans tidigare sparade vytillstånd.

(Ärvd från Parameter)
IStateManager.SaveViewState()

Sparar ändringarna i Parameter objektets visningstillstånd sedan den tid då sidan publicerades tillbaka till servern.

(Ärvd från Parameter)
IStateManager.TrackViewState()

Parameter Gör att objektet spårar ändringar i dess visningstillstånd så att de kan lagras i kontrollens ViewState objekt och sparas mellan begäranden för samma sida.

(Ärvd från Parameter)

Gäller för

Se även