SessionParameter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wiąże wartość zmiennej sesji z obiektem parametrów.

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

Dziedziczenie: Object

Parameter
SessionParameter

Przykłady

W poniższym przykładzie pokazano, jak używać SessionParameter obiektu. W przykładzie przyjęto założenie, że inna strona przechowuje wartość identyfikatora pracownika w zmiennej sesji o nazwie empid. Przykładowa strona używa zmiennej empid sesji w Where klauzuli zapytania i wyświetla wynik zapytania w kontrolce GridView . DefaultValue Ponieważ właściwość SessionParameter obiektu jest ustawiona na 5, dane dla rekordu o employeeID wartości 5 będą nadal wyświetlane, jeśli nie ustawiono zmiennej sesji o nazwie empid przed uruchomieniem przykładu.

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

Uwagi

SessionParameter Obiekt jest zwykle używany w celu uwzględnienia wartości HttpSessionState zmiennej w Where klauzuli zapytania bazy danych. Właściwość SessionField identyfikuje zmienną sesji, z której SessionParameter pobiera wartość.

Uwaga

Kontrolki, które wiążą dane z parametrem SessionParameter przy użyciu obiektu, mogą zgłaszać wyjątek, jeśli określona zmienna sesji nie jest ustawiona. Aby uniknąć tego błędu (jeśli jest to konieczne), ustaw DefaultValue właściwość .

Konstruktory

SessionParameter()	Inicjuje SessionParameter nowe, nienazwane wystąpienie klasy .
SessionParameter(SessionParameter)	Inicjuje nowe wystąpienie SessionParameter klasy z wartościami wystąpienia określonego `original` przez parametr .
SessionParameter(String, DbType, String)	Inicjuje SessionParameter nowe wystąpienie klasy przy użyciu określonej nazwy i typu oraz powiązanie parametru z określoną parą nazwa/wartość stanu sesji. Ten konstruktor jest przeznaczony dla typów baz danych.
SessionParameter(String, String)	Inicjuje nowe nazwane wystąpienie SessionParameter klasy przy użyciu określonego ciągu, aby określić, z którą parą nazwa/wartość stanu sesji ma być powiązana.
SessionParameter(String, TypeCode, String)	Inicjuje nowe nazwane i silnie typizowane wystąpienie SessionParameter klasy przy użyciu określonego ciągu w celu zidentyfikowania pary nazwa/wartość sesji, z którą ma być powiązana.

Właściwości

ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, czy wartość, Parameter z którą obiekt jest powiązany, powinna zostać przekonwertowana na `null` wartość , jeśli jest Emptyto . (Odziedziczone po Parameter)
DbType	Pobiera lub ustawia typ bazy danych parametru. (Odziedziczone po Parameter)
DefaultValue	Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowanym podczas wywoływania Evaluate(HttpContext, Control) metody. (Odziedziczone po Parameter)
Direction	Wskazuje, czy Parameter obiekt jest używany do powiązania wartości z kontrolką, czy kontrolki można użyć do zmiany wartości. (Odziedziczone po Parameter)
IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter)
Name	Pobiera lub ustawia nazwę parametru. (Odziedziczone po Parameter)
SessionField	Pobiera lub ustawia nazwę zmiennej sesji, z którą jest powiązany parametr.
Size	Pobiera lub ustawia rozmiar parametru. (Odziedziczone po Parameter)
Type	Pobiera lub ustawia typ parametru. (Odziedziczone po Parameter)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu Parameter widoku obiektu w wielu żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Metody

Clone()	Zwraca duplikat bieżącego SessionParameter wystąpienia.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Evaluate(HttpContext, Control)	Aktualizacje i zwraca wartość SessionParameter obiektu.
GetDatabaseType()	DbType Pobiera wartość równoważną typowi CLR bieżącego Parameter wystąpienia. (Odziedziczone po Parameter)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnParameterChanged()	Wywołuje metodę OnParametersChanged(EventArgs) kolekcji ParameterCollection zawierającej Parameter obiekt . (Odziedziczone po Parameter)
SaveViewState()	Zapisuje zmiany Parameter stanu widoku obiektu od momentu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter)
SetDirty()	Oznacza obiekt tak Parameter , aby jego stan był rejestrowany w stanie widoku. (Odziedziczone po Parameter)
ToString()	Konwertuje wartość tego wystąpienia na jego równoważną reprezentację w postaci ciągu. (Odziedziczone po Parameter)
TrackViewState()	Parameter Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Jawne implementacje interfejsu

ICloneable.Clone()	Zwraca duplikat bieżącego Parameter wystąpienia. (Odziedziczone po Parameter)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po Parameter)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po Parameter)
IStateManager.SaveViewState()	Zapisuje zmiany Parameter stanu widoku obiektu od momentu opublikowania strony z powrotem na serwerze. (Odziedziczone po Parameter)
IStateManager.TrackViewState()	Parameter Powoduje, że obiekt śledzi zmiany stanu widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po Parameter)

Dotyczy