OleDbParameter 建構函式

定義

命名空間:: System.Data.OleDb

組件:: System.Data.dll

重要

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

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

多載

名稱	Description
OleDbParameter()	初始化 OleDbParameter 類別的新執行個體。
OleDbParameter(String, OleDbType)	初始化使用參數名稱與資料型態的類別新實例 OleDbParameter 。
OleDbParameter(String, Object)	初始化一個使用參數名稱及新OleDbParameter值的類別實例OleDbParameter。
OleDbParameter(String, OleDbType, Int32)	初始化一個使用參數名稱、資料型態及長度的新類別實例 OleDbParameter 。
OleDbParameter(String, OleDbType, Int32, String)	初始化一個使用參數名稱、資料型態、長度及來源欄位名稱的類別新實例 OleDbParameter 。
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	初始化一個新的類別實例，該實例 OleDbParameter 使用參數名稱、資料型別、長度、來源欄位名稱、參數方向、數值精度及其他屬性。
OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)	初始化一個新的類別實例，該實例 OleDbParameter 使用參數名稱、資料型別、長度、來源欄位名稱、參數方向、數值精度及其他屬性。

OleDbParameter()

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

public:
 OleDbParameter();

public OleDbParameter();

Public Sub New ()

範例

以下範例建立並 OleDbParameter 設定其部分性質。

public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter();
   parameter.ParameterName = "Description";
   parameter.OleDbType = OleDbType.VarChar;
   parameter.Direction = ParameterDirection.Output;
   parameter.Size = 88;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter()
    parameter.ParameterName = "Description"
    parameter.OleDbType = OleDbType.VarChar
    parameter.Direction = ParameterDirection.Output
    parameter.Size = 88
End Sub

另請參閱

與指令合作

適用於

OleDbParameter(String, OleDbType)

初始化使用參數名稱與資料型態的類別新實例 OleDbParameter 。

public:
 OleDbParameter(System::String ^ name, System::Data::OleDb::OleDbType dataType);

public OleDbParameter(string name, System.Data.OleDb.OleDbType dataType);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, dataType As OleDbType)

參數

name: String

映射的參數名稱。

dataType: OleDbType

這是其中一項 OleDbType 價值。

例外狀況

ArgumentException

參數中提供的 dataType 值是無效的後端資料型別。

範例

以下範例建立並 OleDbParameter 設定其部分性質。


public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter("Description",OleDbType.VarChar);
   parameter.Direction = ParameterDirection.Output;
   parameter.Size = 88;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = 88
End Sub

備註

資料型態，以及如適用， Size 以及和 Precision 都是從參數值 dataType 推斷而來。

另請參閱

與指令合作

適用於

OleDbParameter(String, Object)

初始化一個使用參數名稱及新OleDbParameter值的類別實例OleDbParameter。

public:
 OleDbParameter(System::String ^ name, System::Object ^ value);

public OleDbParameter(string name, object value);

new System.Data.OleDb.OleDbParameter : string * obj -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, value As Object)

參數

name: String

映射的參數名稱。

value: Object

新物件的 OleDbParameter 價值。

範例

以下範例會產生一個 OleDbParameter。


public static void CreateOleDbParameter()
{
   OleDbParameter myParameter = new OleDbParameter("Description", "Beverages");
}


Public Shared Sub CreateOleDbParameter() 
   Dim myParameter As New OleDbParameter("Description", "Beverages")
End Sub

備註

使用這種建構子過載 OleDbParameter 來指定整數參數值時，請特別小心。由於此超載取的是一個 value 型別 Object為，當值為零時，你必須將整數值轉換為型 Object 別，正如以下 C# 範例所示。

Parameter = new OleDbParameter("@pname", Convert.ToInt32(0));

若不執行此轉換，編譯器會假設你正在嘗試呼叫 OleDbParameter 建構子過載。

另請參閱

與指令合作

適用於

OleDbParameter(String, OleDbType, Int32)

初始化一個使用參數名稱、資料型態及長度的新類別實例 OleDbParameter 。

public:
 OleDbParameter(System::String ^ name, System::Data::OleDb::OleDbType dataType, int size);

public OleDbParameter(string name, System.Data.OleDb.OleDbType dataType, int size);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, dataType As OleDbType, size As Integer)

參數

name: String

映射的參數名稱。

dataType: OleDbType

這是其中一項 OleDbType 價值。

size: Int32

參數的長度。

例外狀況

ArgumentException

參數中提供的 dataType 值是無效的後端資料型別。

範例

以下範例建立並 OleDbParameter 設定其部分性質。


public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter("Description",OleDbType.VarChar,88);
   parameter.Direction = ParameterDirection.Output;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar, 88)
    parameter.Direction = ParameterDirection.Output
End Sub

備註

Size若參數未明確設定，size則由參數值推斷dataType。

另請參閱

與指令合作

適用於

OleDbParameter(String, OleDbType, Int32, String)

初始化一個使用參數名稱、資料型態、長度及來源欄位名稱的類別新實例 OleDbParameter 。

public:
 OleDbParameter(System::String ^ name, System::Data::OleDb::OleDbType dataType, int size, System::String ^ srcColumn);

public OleDbParameter(string name, System.Data.OleDb.OleDbType dataType, int size, string srcColumn);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int * string -> System.Data.OleDb.OleDbParameter

Public Sub New (name As String, dataType As OleDbType, size As Integer, srcColumn As String)

參數

name: String

映射的參數名稱。

dataType: OleDbType

這是其中一項 OleDbType 價值。

size: Int32

參數的長度。

srcColumn: String

來源欄的名稱。

例外狀況

ArgumentException

參數中提供的 dataType 值是無效的後端資料型別。

範例

以下範例建立並 OleDbParameter 設定其部分性質。


public void CreateOleDbParameter()
{
   OleDbParameter parameter = new OleDbParameter(
       "Description",OleDbType.VarChar,
       88,"Description");
   parameter.Direction = ParameterDirection.Output;
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter( _
        "Description", OleDbType.VarChar, 88, "Description")
    parameter.Direction = ParameterDirection.Output
End Sub

備註

Size若參數未明確設定，size則由參數值推斷dataType。

另請參閱

與指令合作

適用於

OleDbParameter(String, OleDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)

初始化一個新的類別實例，該實例 OleDbParameter 使用參數名稱、資料型別、長度、來源欄位名稱、參數方向、數值精度及其他屬性。

public:
 OleDbParameter(System::String ^ parameterName, System::Data::OleDb::OleDbType dbType, int size, System::Data::ParameterDirection direction, bool isNullable, System::Byte precision, System::Byte scale, System::String ^ srcColumn, System::Data::DataRowVersion srcVersion, System::Object ^ value);

public OleDbParameter(string parameterName, System.Data.OleDb.OleDbType dbType, int size, System.Data.ParameterDirection direction, bool isNullable, byte precision, byte scale, string srcColumn, System.Data.DataRowVersion srcVersion, object value);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int * System.Data.ParameterDirection * bool * byte * byte * string * System.Data.DataRowVersion * obj -> System.Data.OleDb.OleDbParameter

Public Sub New (parameterName As String, dbType As OleDbType, size As Integer, direction As ParameterDirection, isNullable As Boolean, precision As Byte, scale As Byte, srcColumn As String, srcVersion As DataRowVersion, value As Object)

參數

parameterName: String

參數的名稱。

dbType: OleDbType

這是其中一項 OleDbType 價值。

size: Int32

參數的長度。

direction: ParameterDirection

這是其中一項 ParameterDirection 價值。

isNullable: Boolean

true 如果欄位的值可以為零;否則 false。

precision: Byte

解決到小數點 Value 左右兩位的總數字數。

scale: Byte

解決到的小數 Value 點數總數。

srcColumn: String

來源欄的名稱。

srcVersion: DataRowVersion

這是其中一項 DataRowVersion 價值。

value: Object

且 Object 是的 OleDbParameter值。

例外狀況

ArgumentException

參數中提供的 dbType 值是無效的後端資料型別。

範例

以下範例會產生， OleDbParameter 並顯示 ParameterName。

public void CreateOleDbParameter()
{
    OleDbParameter parameter = new OleDbParameter(
        "Description", OleDbType.VarChar, 11,
        ParameterDirection.Output, true, 0, 0, "Description",
        DataRowVersion.Current, "garden hose");
    Console.WriteLine(parameter.ToString());
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter( _
        "Description", OleDbType.VarChar, 11, _
        ParameterDirection.Output, True, 0, 0, _
        "Description", DataRowVersion.Current, "garden hose")
    Console.WriteLine(parameter.ToString())
End Sub

備註

Size若和 Precision 未明確設定於size參數precision中，則可從參數值dataType推斷出。

另請參閱

與指令合作

適用於

OleDbParameter(String, OleDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object)

初始化一個新的類別實例，該實例 OleDbParameter 使用參數名稱、資料型別、長度、來源欄位名稱、參數方向、數值精度及其他屬性。

public:
 OleDbParameter(System::String ^ parameterName, System::Data::OleDb::OleDbType dbType, int size, System::Data::ParameterDirection direction, System::Byte precision, System::Byte scale, System::String ^ sourceColumn, System::Data::DataRowVersion sourceVersion, bool sourceColumnNullMapping, System::Object ^ value);

public OleDbParameter(string parameterName, System.Data.OleDb.OleDbType dbType, int size, System.Data.ParameterDirection direction, byte precision, byte scale, string sourceColumn, System.Data.DataRowVersion sourceVersion, bool sourceColumnNullMapping, object value);

new System.Data.OleDb.OleDbParameter : string * System.Data.OleDb.OleDbType * int * System.Data.ParameterDirection * byte * byte * string * System.Data.DataRowVersion * bool * obj -> System.Data.OleDb.OleDbParameter

Public Sub New (parameterName As String, dbType As OleDbType, size As Integer, direction As ParameterDirection, precision As Byte, scale As Byte, sourceColumn As String, sourceVersion As DataRowVersion, sourceColumnNullMapping As Boolean, value As Object)

參數

parameterName: String

參數的名稱。

dbType: OleDbType

這是其中一項 OleDbType 價值。

size: Int32

參數的長度。

direction: ParameterDirection

這是其中一項 ParameterDirection 價值。

precision: Byte

解決到小數點 Value 左右兩位的總數字數。

scale: Byte

解決到的小數 Value 點數總數。

sourceColumn: String

來源欄的名稱。

sourceVersion: DataRowVersion

這是其中一項 DataRowVersion 價值。

sourceColumnNullMapping: Boolean

true 如果來源欄位是可空的; false 如果不是的話。

value: Object

且 Object 是的 OleDbParameter值。

例外狀況

ArgumentException

參數中提供的 dbType 值是無效的後端資料型別。

範例

以下範例會產生， OleDbParameter 並顯示 ParameterName。

public void CreateOleDbParameter()
{
    OleDbParameter parameter = new OleDbParameter(
        "Description", OleDbType.VarChar, 11,
        ParameterDirection.Output, true, 0, 0, "Description",
        DataRowVersion.Current, "garden hose");
    Console.WriteLine(parameter.ToString());
}

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter( _
        "Description", OleDbType.VarChar, 11, _
        ParameterDirection.Output, True, 0, 0, _
        "Description", DataRowVersion.Current, "garden hose")
    Console.WriteLine(parameter.ToString())
End Sub

備註

Size若和 Precision 未明確設定於size參數precision中，則可從參數值dataType推斷出。

另請參閱

與指令合作

適用於

意見反應

此頁面對您有幫助嗎？