Parameter 建構函式

參考

定義

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

組件:: System.Web.dll

重要

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

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

多載

Parameter()	初始化 Parameter 類別預設的新執行個體。
Parameter(String)	使用指定的名稱來初始化 Parameter 類別的新執行個體。
Parameter(Parameter)	使用原始、指定之執行個體的值，初始化 Parameter 類別的新執行個體。
Parameter(String, DbType)	使用指定的名稱和資料庫型別，初始化 Parameter 類別的新執行個體。
Parameter(String, TypeCode)	使用指定的名稱和型別來初始化 Parameter 類別的新執行個體。
Parameter(String, DbType, String)	使用指定的名稱、指定的資料庫型別，以及其 Parameter 屬性的指定值，初始化 DefaultValue 類別的新執行個體。
Parameter(String, TypeCode, String)	使用指定的名稱、指定的型別和為其 Parameter 屬性指定的字串來初始化 DefaultValue 類別的新執行個體。

Parameter()

初始化 Parameter 類別預設的新執行個體。

public:
 Parameter();

public Parameter ();

Public Sub New ()

備註

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

適用於

Parameter(String)

使用指定的名稱來初始化 Parameter 類別的新執行個體。

public:
 Parameter(System::String ^ name);

public Parameter (string name);

new System.Web.UI.WebControls.Parameter : string -> System.Web.UI.WebControls.Parameter

Public Sub New (name As String)

參數

name: String

參數名稱。

範例

下列程式碼範例示範如何從擴充 Parameter 類別的類別呼叫 Parameter(String) 建構函式，以初始化 Name 實例的屬性。此程式碼範例是類別概觀所提供較大範例的 Parameter 一部分。

// The StaticParameter(string, object) constructor
// initializes the DataValue property and calls the
// Parameter(string) constructor to initialize the Name property.
public StaticParameter(string name, object value) : base(name) {
  DataValue = value;
}

' The StaticParameter(string, object) constructor
' initializes the DataValue property and calls the
' Parameter(string) constructor to initialize the Name property.
 Public Sub New(name As String, value As Object)
    MyBase.New(name)
    DataValue = value
 End Sub

備註

Parameter使用建構函式建立的 Parameter(String) 物件會使用其其他屬性的指定 name 和預設值初始化。屬性會初始化為，屬性 Type 會初始化為 Input ，而 DefaultValue 屬性則會初始化為 null 。 Direction TypeCode.Object

另請參閱

Name

適用於

Parameter(Parameter)

使用原始、指定之執行個體的值，初始化 Parameter 類別的新執行個體。

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

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

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

Protected Sub New (original As Parameter)

參數

original: Parameter

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

範例

下列程式碼範例示範如何從擴充 Parameter 類別的類別呼叫 Parameter(Parameter) 建構函式，以實作類別的正確物件複製行為。此程式碼範例是類別概觀所提供較大範例的 Parameter 一部分。

// The StaticParameter copy constructor is provided to ensure that
// the state contained in the DataValue property is copied to new
// instances of the class.
protected StaticParameter(StaticParameter original) : base(original) {
  DataValue = original.DataValue;
}

// The Clone method is overridden to call the
// StaticParameter copy constructor, so that the data in
// the DataValue property is correctly transferred to the
// new instance of the StaticParameter.
protected override Parameter Clone() {
  return new StaticParameter(this);
}

' The StaticParameter copy constructor is provided to ensure that
' the state contained in the DataValue property is copied to new
' instances of the class.
Protected Sub New(original As StaticParameter)
   MyBase.New(original)
   DataValue = original.DataValue
End Sub

' The Clone method is overridden to call the
' StaticParameter copy constructor, so that the data in
' the DataValue property is correctly transferred to the
' new instance of the StaticParameter.
Protected Overrides Function Clone() As Parameter
   Return New StaticParameter(Me)
End Function

備註

建 Parameter(Parameter) 構函式是 protected 用來複製實例的 Parameter 複製建構函式。、 Type 、 DefaultValue 、 Direction 和 ConvertEmptyStringToNull 屬性的值 Name 全都會傳輸至新的實例。

另請參閱

Clone()

適用於

Parameter(String, DbType)

使用指定的名稱和資料庫型別，初始化 Parameter 類別的新執行個體。

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

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

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

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

參數

name: String

參數名稱。

dbType: DbType

參數的資料庫型別。

備註

Parameter使用建構函式建立的物件 Parameter(String, DbType) 會以指定的 name 和 dbType 參數初始化，並使用其他屬性的預設值初始化。屬性 Direction 會初始化為 Input ，而且 DefaultValue 屬性會初始化為 null 。

適用於

Parameter(String, TypeCode)

使用指定的名稱和型別來初始化 Parameter 類別的新執行個體。

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

public Parameter (string name, TypeCode type);

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

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

參數

name: String

參數名稱。

type: TypeCode

TypeCode，描述參數的型別。

範例

下列程式碼範例示範如何從擴充 Parameter 類別的類別呼叫 Parameter(String, TypeCode) 建構函式，以初始化 Name 實例的和 Type 屬性。此程式碼範例是類別概觀所提供較大範例的 Parameter 一部分。

// The StaticParameter(string, TypeCode, object) constructor
// initializes the DataValue property and calls the
// Parameter(string, TypeCode) constructor to initialize the Name and
// Type properties.
public StaticParameter(string name, TypeCode type, object value) : base(name, type) {
  DataValue = value;
}

' The StaticParameter(string, TypeCode, object) constructor
' initializes the DataValue property and calls the
' Parameter(string, TypeCode) constructor to initialize the Name and
' Type properties.
Public Sub New(name As String, type As TypeCode, value As Object)
   MyBase.New(name, type)
   DataValue = value
End Sub

備註

Parameter使用建構函式建立的物件 Parameter(String, TypeCode) 會使用指定的 name 和 type 參數初始化，以及其他屬性的預設值。屬性 Direction 會初始化為 Input ，而且 DefaultValue 屬性會初始化為 null 。

另請參閱

Name
Type

適用於

Parameter(String, DbType, String)

使用指定的名稱、指定的資料庫型別，以及其 Parameter 屬性的指定值，初始化 DefaultValue 類別的新執行個體。

public:
 Parameter(System::String ^ name, System::Data::DbType dbType, System::String ^ defaultValue);

public Parameter (string name, System.Data.DbType dbType, string defaultValue);

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

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

參數

name: String

Parameter 執行個體的名稱。

dbType: DbType

Parameter 執行個體的資料庫型別。

defaultValue: String

如果在呼叫 Parameter 時，Parameter 繫結至尚未初始化的值，則為 Evaluate(HttpContext, Control) 執行個體的預設值。

備註

實例 Direction 的 Parameter 屬性會初始化為 Input 。

適用於

Parameter(String, TypeCode, String)

使用指定的名稱、指定的型別和為其 Parameter 屬性指定的字串來初始化 DefaultValue 類別的新執行個體。

public:
 Parameter(System::String ^ name, TypeCode type, System::String ^ defaultValue);

public Parameter (string name, TypeCode type, string defaultValue);

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

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

參數

name: String

參數名稱。

type: TypeCode

TypeCode，描述參數的型別。

defaultValue: String

如果這個 Parameter 繫結的值，在呼叫 Evaluate(HttpContext, Control) 時尚未被初始化，則字串會做為參數的預設值。

範例

下列程式碼範例示範如何使用建 Parameter(String, TypeCode, String) 構函式，在呼叫 Update 方法之前，將更新參數物件新增至 UpdateParameters 控制項的 AccessDataSource 集合。

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  // This method is an example of batch updating using a
  // data source control. The method iterates through the rows
  // of the GridView, extracts each CheckBox from the row and, if
  // the CheckBox is checked, updates data by calling the Update
  // method of the data source control, adding required parameters
  // to the UpdateParameters collection.
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add(new Parameter("date",TypeCode.DateTime,DateTime.Now.ToString()));
      MyAccessDataSource.UpdateParameters.Add(new Parameter("orderid",TypeCode.String,oid));
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  ' This method is an example of batch updating using a
  ' data source control. The method iterates through the rows
  ' of the GridView, extracts each CheckBox from the row and, if
  ' the CheckBox is checked, updates data by calling the Update
  ' method of the data source control, adding required parameters
  ' to the UpdateParameters collection.

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      Dim param1 As New Parameter("date", TypeCode.DateTime, DateTime.Now.ToString())
      MyAccessDataSource.UpdateParameters.Add(param1)

      Dim param2 As New Parameter("orderid", TypeCode.String, oid)
      MyAccessDataSource.UpdateParameters.Add(param2)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

備註

Parameter使用建構函式建立的物件 Parameter(String, TypeCode, String) 會以指定的 name 參數和 type 參數初始化，並指派 DefaultValue 屬性值。 Direction 屬性會初始化為 Input。

另請參閱

適用於

共用方式為

Parameter 建構函式

定義

多載

Parameter()

備註

適用於

Parameter(String)

參數

範例

備註

另請參閱

適用於

Parameter(Parameter)

參數

範例

備註

另請參閱

適用於

Parameter(String, DbType)

參數

備註

適用於

Parameter(String, TypeCode)

參數

範例

備註

另請參閱

適用於

Parameter(String, DbType, String)

參數

備註

適用於

Parameter(String, TypeCode, String)

參數

範例

備註

另請參閱

適用於

其他資源