OleDbParameter 建構函式

參考

定義

命名空間:: System.Data.OleDb

組件:: System.Data.OleDb.dll

組件:: System.Data.dll

套件:: System.Data.OleDb v6.0.0

套件:: System.Data.OleDb v7.0.0

套件:: System.Data.OleDb v8.0.0

套件:: System.Data.OleDb v9.0.0-preview.2.24128.5

重要

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

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

多載

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.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 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.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 OleDbParameter 類別的新執行個體，該類別使用參數名稱和資料型別。

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

public OleDbParameter (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則會從參數的值dataType推斷和 Precision 。

另請參閱

使用命令

適用於

OleDbParameter(String, Object)

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 OleDbParameter 類別的新執行個體，該類別使用參數名稱和新 OleDbParameter 的值。

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

public OleDbParameter (string name, 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 載來指定整數參數值時，請小心。由於這個多載接受 Object 型別的 value，因此您必須在值為零時將整數值轉換成 Object 型別，如下面的 C# 範例所示。

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

如果您未執行此轉換，編譯程式會假設您嘗試呼叫建 OleDbParameter 構函式多載。

另請參閱

使用命令

適用於

OleDbParameter(String, OleDbType, Int32)

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 OleDbParameter 類別的新執行個體，該類別使用參數名稱、資料型別和長度。

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

public OleDbParameter (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.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 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);

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.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 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);

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

如果欄位值可以是 null，則為 true；否則為 false。

precision: Byte

Value 所解析的小數點左右側的位數總數。

scale: Byte

Value 所解析的小數點位數的總數。

srcColumn: String

來源資料行的名稱。

srcVersion: DataRowVersion

其中一個 DataRowVersion 值。

value: Object

Object，是 OleDbParameter 的值。

例外狀況

ArgumentException

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

範例

下列範例會 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 未在和 precision 參數中size明確設定，則會從參數的值dataType推斷。

另請參閱

使用命令

適用於

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

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

來源:: OleDbParameter.cs

初始化 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);

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

如果來源資料行可為 Null，則為 true；否則為 false。

value: Object

Object，是 OleDbParameter 的值。

例外狀況

ArgumentException

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

範例

下列範例會 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 未在和 precision 參數中size明確設定，則會從參數的值dataType推斷。

另請參閱

使用命令

適用於

OleDbParameter 建構函式

定義

多載

OleDbParameter()

範例

另請參閱

適用於

OleDbParameter(String, OleDbType)

參數

例外狀況

範例

備註

另請參閱

適用於

OleDbParameter(String, Object)

參數

範例

備註

另請參閱

適用於

OleDbParameter(String, OleDbType, Int32)

參數

例外狀況

範例

備註

另請參閱

適用於

OleDbParameter(String, OleDbType, Int32, String)

參數

例外狀況

範例

備註

另請參閱

適用於

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

參數

例外狀況

範例

備註

另請參閱

適用於

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

參數

例外狀況

範例

備註

另請參閱

適用於

意見反應

其他資源