CookieParameter 建構函式

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 CookieParameter 類別的新執行個體。

多載

CookieParameter()	初始化 CookieParameter 類別未命名的新執行個體。
CookieParameter(CookieParameter)	使用 `original` 參數所指定的執行個體值，初始化 CookieParameter 類別的新執行個體。
CookieParameter(String, String)	利用用於識別要繫結至之 HTTP Cookie 的指定字串，初始化 CookieParameter 類別的新具名執行個體。
CookieParameter(String, DbType, String)	初始化 CookieParameter 類別的新執行個體，該類別擁有指定的名稱和資料庫型別，而且繫結至指定的 HTTP Cookie。
CookieParameter(String, TypeCode, String)	利用用於識別要繫結至之 HTTP Cookie 的指定字串，初始化 CookieParameter 類別的新具名強型別 (Strongly Typed) 執行個體。

CookieParameter()

初始化 CookieParameter 類別未命名的新執行個體。

public:
 CookieParameter();

public CookieParameter ();

Public Sub New ()

範例

下列程式碼範例示範如何使用建 CookieParameter 構函式建立 CookieParameter 物件、設定其 Name 、 Type 和 CookieName 屬性，然後將它新增至 SqlDataSource 控制項的 SelectParameters 集合。

<%@ Page Language="C#" CodeFile="cookieparam2cs.aspx.cs" Inherits="cookieparam2cs_aspx" %> 
<!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" runat="server">
    <div>
      <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)">
      </asp:SqlDataSource>

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

<%@ Page Language="VB" AutoEventWireup="false" CodeFile="cookieparam2vb.aspx.vb" Inherits="cookieparam2vb_aspx" %>
<!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" runat="server">
    <div>
      <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)">
      </asp:SqlDataSource>

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

下列程式碼後置模組會與上一個Web Form頁面搭配使用。

public partial class cookieparam2cs_aspx : System.Web.UI.Page 
{
    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()));

            // You can add a CookieParameter to the SqlDataSource control's
            // SelectParameters collection programmatically.
            CookieParameter cookieParam = new CookieParameter();
            cookieParam.Name = "lastname";
            cookieParam.Type = TypeCode.String;
            cookieParam.CookieName = "lname";

            SqlDataSource1.SelectParameters.Add(cookieParam);
        }
    }
}

Partial Class cookieparam2vb_aspx
    Inherits System.Web.UI.Page
    Sub Page_Load(ByVal sender As Object, ByVal 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)


            ' You can add a CookieParameter to the SqlDataSource control's
            ' SelectParameters collection programmatically.
            Dim cookieParam As New CookieParameter()
            cookieParam.Name = "lastname"
            cookieParam.Type = TypeCode.String
            cookieParam.CookieName = "lname"

            SqlDataSource1.SelectParameters.Add(cookieParam)

        End If
    End Sub
End Class

備註

CookieParameter使用建構函式建立的物件 CookieParameter 會使用其所有屬性的預設值初始化。 CookieName 屬性會初始化為 String.Empty。此外， Name 屬性會初始化為 String.Empty 、 TypeCode.Object Type 屬性初始化為、 Direction 屬性 Input 初始化為，而 DefaultValue 屬性則會初始化為 null 。

適用於

CookieParameter(CookieParameter)

使用 original 參數所指定的執行個體值，初始化 CookieParameter 類別的新執行個體。

protected:
 CookieParameter(System::Web::UI::WebControls::CookieParameter ^ original);

protected CookieParameter (System.Web.UI.WebControls.CookieParameter original);

new System.Web.UI.WebControls.CookieParameter : System.Web.UI.WebControls.CookieParameter -> System.Web.UI.WebControls.CookieParameter

Protected Sub New (original As CookieParameter)

參數

original: CookieParameter

CookieParameter，初始化目前執行個體的起源。

備註

建 CookieParameter 構函式是 protected 用來複製實例的 CookieParameter 複製建構函式。物件的屬性值 CookieParameter ，包括 CookieName 、 Name 和 Type ，全都會傳輸至新的實例。

另請參閱

Clone()

適用於

CookieParameter(String, String)

利用用於識別要繫結至之 HTTP Cookie 的指定字串，初始化 CookieParameter 類別的新具名執行個體。

public:
 CookieParameter(System::String ^ name, System::String ^ cookieName);

public CookieParameter (string name, string cookieName);

new System.Web.UI.WebControls.CookieParameter : string * string -> System.Web.UI.WebControls.CookieParameter

Public Sub New (name As String, cookieName As String)

參數

name: String

參數名稱。

cookieName: String

參數物件繫結至的 HTTP Cookie 名稱。預設為 Empty。

範例

下列程式碼範例示範如何使用建構函式建立 CookieParameter 物件 CookieParameter ，並將它新增至 SqlDataSource 控制項的 SelectParameters 集合。

// You can programmatically add a CookieParameter to the
// SqlDataSource control's SelectParameters collection.
CookieParameter cookieParam = new CookieParameter("lastname","lname");
SqlDataSource1.SelectParameters.Add(cookieParam);

' You can  programmatically add a CookieParameter to the
' SqlDataSource control's SelectParameters collection.
Dim cookieParam As New CookieParameter("lastname","lname")
SqlDataSource1.SelectParameters.Add(cookieParam)

備註

CookieParameter使用建構函式建立的 CookieParameter 物件會以指定的參數名稱和字串初始化，以識別參數系結的 Cookie。其他屬性包括 Type 和 Direction ，會以預設值初始化。

另請參閱

適用於

CookieParameter(String, DbType, String)

初始化 CookieParameter 類別的新執行個體，該類別擁有指定的名稱和資料庫型別，而且繫結至指定的 HTTP Cookie。

public:
 CookieParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ cookieName);

public CookieParameter (string name, System.Data.DbType dbType, string cookieName);

new System.Web.UI.WebControls.CookieParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.CookieParameter

Public Sub New (name As String, dbType As DbType, cookieName As String)

參數

name: String

參數名稱。

dbType: DbType

參數所代表的資料庫型別。

cookieName: String

參數物件繫結至的 HTTP Cookie 名稱。預設為 Empty。

另請參閱

適用於

CookieParameter(String, TypeCode, String)

利用用於識別要繫結至之 HTTP Cookie 的指定字串，初始化 CookieParameter 類別的新具名強型別 (Strongly Typed) 執行個體。

public:
 CookieParameter(System::String ^ name, TypeCode type, System::String ^ cookieName);

public CookieParameter (string name, TypeCode type, string cookieName);

new System.Web.UI.WebControls.CookieParameter : string * TypeCode * string -> System.Web.UI.WebControls.CookieParameter

Public Sub New (name As String, type As TypeCode, cookieName As String)

參數

name: String

參數名稱。

type: TypeCode

參數所代表的型別。預設為 Object。

cookieName: String

參數物件繫結至的 HTTP Cookie 名稱。預設為 Empty。

範例

下列程式碼範例示範如何使用建構函式建立 CookieParameter 物件 CookieParameter ，並將它新增至 SqlDataSource 控制項的 SelectParameters 集合。

// You can programmatically add a CookieParameter to the
// SqlDataSource control's SelectParameters collection.
CookieParameter cookieParam = new CookieParameter("lastname",TypeCode.String,"lname");
SqlDataSource1.SelectParameters.Add(cookieParam);

' You can programmatically add a CookieParameter to the
' SqlDataSource control's SelectParameters collection.
Dim cookieParam As New CookieParameter("lastname",TypeCode.String,"lname")
SqlDataSource1.SelectParameters.Add(cookieParam)

備註

CookieParameter使用建構函式建立的物件 CookieParameter 會使用指定的參數名稱、 Type 和字串初始化，以識別參數系結的 Cookie。 Direction只有和 ConvertEmptyStringToNull 屬性會以預設值初始化。

另請參閱

適用於

共用方式為

CookieParameter 建構函式

定義

多載

CookieParameter()

範例

備註

適用於

CookieParameter(CookieParameter)

參數

備註

另請參閱

適用於

CookieParameter(String, String)

參數

範例

備註

另請參閱

適用於

CookieParameter(String, DbType, String)

參數

另請參閱

適用於

CookieParameter(String, TypeCode, String)

參數

範例

備註

另請參閱

適用於

意見反應

其他資源