CookieParameter Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengikat nilai cookie HTTP sisi klien ke objek parameter. Parameter dapat digunakan dalam kueri atau perintah berparameter untuk memilih, memfilter, atau memperbarui data.

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

Warisan: Object

Parameter
CookieParameter

Contoh

Contoh kode berikut menunjukkan cara menggunakan kontrol dan CookieParameter objek yang SqlDataSource terikat ke cookie HTTP untuk menampilkan data dari database Northwind Traders dalam GridView kontrol.

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

Keterangan

Anda dapat menggunakan CookieParameter kelas untuk mengikat nilai cookie HTTP sisi klien yang diteruskan sebagai bagian dari permintaan HTTP ke parameter yang digunakan oleh kontrol sumber data ASP.NET.

Kelas CookieParameter menyediakan CookieName properti , yang mengidentifikasi nama objek yang HttpCookie akan diikat, selain yang diwarisi dari Parameter kelas . Kelas CookieParameter mencoba mengikat cookie bernama setiap kali metode dipanggil Evaluate .

Penting

Kontrol yang mengikat data ke parameter mungkin melemparkan pengecualian jika CookieParameter objek ditentukan, tetapi tidak ada cookie yang sesuai yang diteruskan dengan permintaan HTTP. Demikian pula, mereka mungkin tidak menampilkan data jika cookie diteruskan dengan null. Atur DefaultValue properti untuk menghindari situasi ini jika sesuai.

Konstruktor

CookieParameter()	Menginisialisasi instans kelas baru yang tidak disebutkan CookieParameter namanya.
CookieParameter(CookieParameter)	Menginisialisasi instans CookieParameter baru kelas dengan nilai instans yang ditentukan oleh `original` parameter .
CookieParameter(String, DbType, String)	Menginisialisasi instans CookieParameter baru kelas yang memiliki nama dan jenis database yang ditentukan dan yang terikat dengan cookie HTTP yang ditentukan.
CookieParameter(String, String)	Menginisialisasi instans CookieParameter baru bernama kelas, menggunakan string yang ditentukan untuk mengidentifikasi cookie HTTP mana yang akan diikat.
CookieParameter(String, TypeCode, String)	Menginisialisasi instans CookieParameter kelas bernama baru yang dinamai dan ditik dengan kuat, menggunakan string yang ditentukan untuk mengidentifikasi cookie HTTP mana yang akan diikat.

Properti

ConvertEmptyStringToNull	Mendapatkan atau menetapkan nilai yang menunjukkan apakah nilai yang Parameter terikat objek harus dikonversi ke `null` jika itu adalah Empty. (Diperoleh dari Parameter)
CookieName	Mendapatkan atau mengatur nama cookie HTTP yang diikat parameter.
DbType	Mendapatkan atau mengatur jenis database parameter. (Diperoleh dari Parameter)
DefaultValue	Menentukan nilai default untuk parameter, jika nilai parameter terikat untuk tidak diinisialisasi saat Evaluate(HttpContext, Control) metode dipanggil. (Diperoleh dari Parameter)
Direction	Menunjukkan apakah Parameter objek digunakan untuk mengikat nilai ke kontrol, atau kontrol dapat digunakan untuk mengubah nilai. (Diperoleh dari Parameter)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
Name	Mendapatkan atau mengatur nama parameter. (Diperoleh dari Parameter)
Size	Mendapatkan atau mengatur ukuran parameter. (Diperoleh dari Parameter)
Type	Mendapatkan atau mengatur jenis parameter. (Diperoleh dari Parameter)
ValidateInput	Mendapatkan atau menetapkan nilai yang menentukan apakah nilai parameter divalidasi.
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status Parameter tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Metode

Clone()	Mengembalikan duplikat instans saat ini CookieParameter .
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Evaluate(HttpContext, Control)	Updates dan mengembalikan nilai CookieParameter objek.
GetDatabaseType()	Mendapatkan nilai yang setara dengan jenis CLR instans DbType saat ini Parameter . (Diperoleh dari Parameter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari Parameter)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnParameterChanged()	OnParametersChanged(EventArgs) Memanggil metode ParameterCollection koleksi yang berisi Parameter objek . (Diperoleh dari Parameter)
SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
SetDirty()	Parameter Menandai objek sehingga statusnya akan direkam dalam status tampilan. (Diperoleh dari Parameter)
ToString()	Mengonversi nilai instans ini ke representasi string yang setara. (Diperoleh dari Parameter)
TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Mengembalikan duplikat instans saat ini Parameter . (Diperoleh dari Parameter)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah Parameter objek menyimpan perubahan pada status tampilannya. (Diperoleh dari Parameter)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari Parameter)
IStateManager.SaveViewState()	Menyimpan perubahan ke Parameter status tampilan objek sejak halaman diposting kembali ke server. (Diperoleh dari Parameter)
IStateManager.TrackViewState()	Parameter Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di objek kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari Parameter)

Berlaku untuk

Bagikan melalui