CookieParameter Sınıf

Tanım

İstemci tarafı HTTP tanımlama bilgisinin değerini parametre nesnesine bağlar. Parametre, verileri seçmek, filtrelemek veya güncelleştirmek için parametreli bir sorguda veya komutta kullanılabilir.

public ref class CookieParameter : System::Web::UI::WebControls::Parameter
public class CookieParameter : System.Web.UI.WebControls.Parameter
type CookieParameter = class
    inherit Parameter
Public Class CookieParameter
Inherits Parameter
Devralma
CookieParameter

Örnekler

Aşağıdaki kod örneği, Northwind Traders veritabanındaki verileri bir SqlDataSource denetimde görüntülemek için BIR HTTP tanımlama bilgisine bağlı bir GridView denetimin ve CookieParameter nesnenin nasıl kullanılacağını gösterir.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){
  // These cookies might be added by a login form.
  // They are added here for simplicity.
  if (!IsPostBack) {
      Response.Cookies.Add(new HttpCookie("lname",    "davolio"));
      Response.Cookies.Add(new HttpCookie("loginname","ndavolio"));
      Response.Cookies.Add(new HttpCookie("lastvisit", DateTime.Now.ToString()));
  }
}


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </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">

<script runat="server">

Sub Page_Load(sender As Object, e As EventArgs)
  ' These cookies might be added by a login form.
  ' They are added here for simplicity.
  If (Not IsPostBack) Then
      Dim cookie As HttpCookie

      cookie = New HttpCookie("lname","davolio")
      Response.Cookies.Add(cookie)

      cookie = New HttpCookie("loginname","ndavolio")
      Response.Cookies.Add(cookie)

      cookie = New HttpCookie("lastvisit", DateTime.Now.ToString())
      Response.Cookies.Add(cookie)
  End If
End Sub ' Page_Load
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>                 
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Açıklamalar

http isteğinin CookieParameter bir parçası olarak geçirilen istemci tarafı HTTP tanımlama bilgisinin değerini ASP.NET veri kaynağı denetimleri tarafından kullanılan bir parametreye bağlamak için sınıfını kullanabilirsiniz.

CookieParameter sınıfı, sınıfından CookieName devralınanlara Parameter ek olarak bağlanacak nesnenin HttpCookie adını tanımlayan özelliğini sağlar. sınıfı, CookieParameter yöntem her çağrıldığında adlandırılmış tanımlama bilgisine bağlanmaya Evaluate çalışır.

Önemli

Parametreye veri bağlayan denetimler, bir CookieParameter nesne belirtilirse bir özel durum oluştursa da HTTP isteğiyle ilgili tanımlama bilgisi geçirilmez. Benzer şekilde, tanımlama bilgisi ile nullgeçirilirse veri görüntülemeyebilirler. Uygun durumlarda bu durumlardan DefaultValue kaçınmak için özelliğini ayarlayın.

Oluşturucular

CookieParameter()

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

CookieParameter(CookieParameter)

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

CookieParameter(String, DbType, String)

Belirtilen ada ve veritabanı türüne sahip ve belirtilen HTTP tanımlama bilgisine bağlı olan sınıfın yeni bir örneğini CookieParameter başlatır.

CookieParameter(String, String)

Hangi HTTP tanımlama bilgisinin CookieParameter bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfının yeni bir adlandırılmış örneğini başlatır.

CookieParameter(String, TypeCode, String)

Hangi HTTP tanımlama bilgisinin CookieParameter bağlanacağını belirlemek için belirtilen dizeyi kullanarak sınıfın yeni adlandırılmış ve kesin olarak belirlenmiş 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)
CookieName

Parametresinin bağlandığını HTTP tanımlama bilgisinin adını alır veya ayarlar.

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)
Size

Parametresinin boyutunu alır veya ayarlar.

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

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

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

Parametrenin değerinin doğrulanıp doğrulanmayacağını belirten bir değer alır veya ayarlar.

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 CookieParameter ö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 CookieParameter 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.