SessionParameter Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

Wiąże wartość zmiennej sesji z obiektem 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

Dziedziczenie: Object

Parameter
SessionParameter

Przykłady

W poniższym przykładzie pokazano, jak używać SessionParameter obiektu. W przykładzie założono, że inna strona przechowuje wartość identyfikatora pracownika w zmiennej sesji o nazwie empid. Przykładowa strona używa empid zmiennej 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, który ma employeeID wartość 5, będą nadal wyświetlane, jeśli żadna zmienna sesji o nazwie empid nie zostanie ustawiona 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 (w razie potrzeby), ustaw DefaultValue właściwość .

Konstruktorów

Nazwa	Opis
SessionParameter()	Inicjuje nowe nienazwane wystąpienie SessionParameter klasy.
SessionParameter(SessionParameter)	Inicjuje nowe wystąpienie SessionParameter klasy z wartościami wystąpienia określonego `original` przez parametr .
SessionParameter(String, DbType, String)	Inicjuje nowe wystąpienie SessionParameter 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, używając określonego ciągu w celu zidentyfikowania, 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, z którą parą nazwa/wartość stanu sesji ma być powiązana.

Właściwości

Nazwa	Opis
ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, Parameter czy wartość, którą obiekt jest powiązany, powinna zostać przekonwertowana na `null` wartość , jeśli jest Emptyto . (Dziedziczone od Parameter)
DbType	Pobiera lub ustawia typ bazy danych parametru. (Dziedziczone od Parameter)
DefaultValue	Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowaną, gdy Evaluate(HttpContext, Control) metoda jest wywoływana. (Dziedziczone od 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. (Dziedziczone od Parameter)
IsTrackingViewState	Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku. (Dziedziczone od Parameter)
Name	Pobiera lub ustawia nazwę parametru. (Dziedziczone od Parameter)
SessionField	Pobiera lub ustawia nazwę zmiennej sesji, z którą jest powiązany parametr.
Size	Pobiera lub ustawia rozmiar parametru. (Dziedziczone od Parameter)
Type	Pobiera lub ustawia typ parametru. (Dziedziczone od Parameter)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu Parameter widoku obiektu na wielu żądaniach dla tej samej strony. (Dziedziczone od Parameter)

Metody

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

Implementacje interfejsów jawnych

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

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?