SessionParameter Sınıf

Tanım

Bir oturum değişkeninin değerini parametre nesnesine bağlar.

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
Devralma
SessionParameter

Örnekler

Aşağıdaki örnekte bir nesnenin nasıl kullanılacağı gösterilmektedir SessionParameter . Örnekte, başka bir sayfanın adlı empidbir oturum değişkeninde çalışan kimliği değeri depolandığı varsayılır. Örnek sayfa, sorgunun empid yan tümcesindeki Where oturum değişkenini kullanır ve sorgunun sonucunu bir GridView denetimde görüntüler. nesnesinin DefaultValueSessionParameter özelliği 5 olarak ayarlandığından, örneği çalıştırmadan önce adlı empid bir oturum değişkeni ayarlanmamışsa 5 değerine sahip employeeID kaydın verileri görüntülenmeye devam eder.

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

Açıklamalar

Bir SessionParameter nesne genellikle bir HttpSessionState değişkenin Where değerini veritabanı sorgusunun yan tümcesine eklemek için kullanılır. özelliği, SessionField değerini aldığı oturum değişkenini SessionParameter tanımlar.

Not

Bir nesne kullanarak SessionParameter bir parametreye veri bağlayan denetimler, belirtilen oturum değişkeni ayarlanmadıysa bir özel durum oluşturabilir. Bu hatayı önlemek için (uygunsa) özelliğini ayarlayın DefaultValue .

Oluşturucular

SessionParameter()

sınıfının yeni bir adsız örneğini SessionParameter başlatır.

SessionParameter(SessionParameter)

parametresi tarafından belirtilen örneğin değerleriyle sınıfının yeni bir örneğini SessionParameteroriginal başlatır.

SessionParameter(String, DbType, String)

Belirtilen adı ve türü kullanarak ve parametresini belirtilen oturum durumu adı/değer çiftine bağlayarak sınıfının yeni bir örneğini SessionParameter başlatır. Bu oluşturucu veritabanı türleri içindir.

SessionParameter(String, String)

Hangi oturum durumu adı/değer çiftine SessionParameter bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfının yeni bir adlandırılmış örneğini başlatır.

SessionParameter(String, TypeCode, String)

Hangi oturum durumu adı/değer çiftine SessionParameter bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfın adlandırılmış ve kesin olarak belirlenmiş yeni bir örneğini başlatır.

Özellikler

ConvertEmptyStringToNull

nesnenin bağlı olduğu değerin Parameter ise Emptydeğerine dönüştürülmesi null gerekip gerekmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Parameter)
DbType

Parametresinin veritabanı türünü alır veya ayarlar.

(Devralındığı yer: Parameter)
DefaultValue

Yöntemi çağrıldığında Evaluate(HttpContext, Control) parametrenin başlatılmamış olarak bağlı olduğu değerin parametresi için varsayılan bir değer belirtir.

(Devralındığı yer: Parameter)
Direction

Nesnenin Parameter bir değeri bir denetime bağlamak için kullanılıp kullanılmadığını veya denetimin değeri değiştirmek için kullanılıp kullanılamayacağını gösterir.

(Devralındığı yer: Parameter)
IsTrackingViewState

Nesnenin Parameter görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Parameter)
Name

Parametresinin adını alır veya ayarlar.

(Devralındığı yer: Parameter)
SessionField

Parametrenin bağlandığını oturum değişkeninin adını alır veya ayarlar.

Size

Parametresinin boyutunu alır veya ayarlar.

(Devralındığı yer: Parameter)
Type

Parametresinin türünü alır veya ayarlar.

(Devralındığı yer: Parameter)
ViewState

Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum Parameter bilgileri sözlüğü alır.

(Devralındığı yer: Parameter)

Yöntemler

Clone()

Geçerli SessionParameter örneğin bir kopyasını döndürür.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
Evaluate(HttpContext, Control)

Güncelleştirmeler ve nesnesinin SessionParameter değerini döndürür.

GetDatabaseType()

DbType Geçerli Parameter örneğin CLR türüne eşdeğer değeri alır.

(Devralındığı yer: Parameter)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
LoadViewState(Object)

Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler.

(Devralındığı yer: Parameter)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnParameterChanged()

OnParametersChanged(EventArgs) nesnesini içeren Parameter koleksiyonun ParameterCollection yöntemini çağırır.

(Devralındığı yer: Parameter)
SaveViewState()

Sayfa sunucuya geri gönderildiğinden Parameter beri nesnenin görünüm durumundaki değişiklikleri kaydeder.

(Devralındığı yer: Parameter)
SetDirty()

Parameter Durumu görünüm durumunda kaydedilecek şekilde nesneyi işaretler.

(Devralındığı yer: Parameter)
ToString()

Bu örneğinin değerini eşdeğer dize gösterimine dönüştürür.

(Devralındığı yer: Parameter)
TrackViewState()

Nesnenin görünüm durumundaki Parameter değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

(Devralındığı yer: Parameter)

Belirtik Arabirim Kullanımları

ICloneable.Clone()

Geçerli Parameter örneğin bir kopyasını döndürür.

(Devralındığı yer: Parameter)
IStateManager.IsTrackingViewState

Nesnenin Parameter görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Parameter)
IStateManager.LoadViewState(Object)

Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler.

(Devralındığı yer: Parameter)
IStateManager.SaveViewState()

Sayfa sunucuya geri gönderildiğinden Parameter beri nesnenin görünüm durumundaki değişiklikleri kaydeder.

(Devralındığı yer: Parameter)
IStateManager.TrackViewState()

Nesnenin görünüm durumundaki Parameter değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir.

(Devralındığı yer: Parameter)

Şunlara uygulanır

Ayrıca bkz.