OracleParameterCollection.Add 方法

參考

定義

命名空間:: System.Data.OracleClient

組件:: System.Data.OracleClient.dll

重要

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

將 OracleParameter 加入至 OracleParameterCollection。

多載

Add(OracleParameter)	將指定的 OracleParameter 加入至 OracleParameterCollection。
Add(Object)	將指定的 OracleParameter 物件加入至 OracleParameterCollection。
Add(String, OracleType)	加入 OracleParameter 至提供參數名稱和資料型別的 OracleParameterCollection。
Add(String, Object)	已淘汰. 加入 OracleParameter 至提供參數名稱和值的 OracleParameterCollection。
Add(String, OracleType, Int32)	將 OracleParameter 加入至提供參數名稱、資料型別和資料行長度的 OracleParameterCollection。
Add(String, OracleType, Int32, String)	將 OracleParameter 加入至提供參數名稱、資料型別、資料行長度和來源資料行名稱的 OracleParameterCollection。

Add(OracleParameter)

將指定的 OracleParameter 加入至 OracleParameterCollection。

public:
 System::Data::OracleClient::OracleParameter ^ Add(System::Data::OracleClient::OracleParameter ^ value);

public System.Data.OracleClient.OracleParameter Add (System.Data.OracleClient.OracleParameter value);

member this.Add : System.Data.OracleClient.OracleParameter -> System.Data.OracleClient.OracleParameter

override this.Add : System.Data.OracleClient.OracleParameter -> System.Data.OracleClient.OracleParameter

Public Function Add (value As OracleParameter) As OracleParameter

參數

value: OracleParameter

要加入至集合的 OracleParameter。

傳回

OracleParameter

新 OracleParameter 物件的參考。

例外狀況

ArgumentException

value 參數中指定的 OracleParameter 已經加入至這個或另一個 OracleParameterCollection。

ArgumentNullException

value 參數為 null。

範例

下列範例會 OracleParameterCollection建立、將的 OracleParameter 實例加入至集合，並傳回新 OracleParameter的參考。

public void CreateOracleParamColl() {
    OracleCommand command = new OracleCommand(
        "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection);
    OracleParameterCollection paramCollection = command.Parameters;
    object parameter = new OracleParameter("pEmpNo", OracleType.Number);
    int pIndex = paramCollection.Add(parameter);
 }

Public Sub CreateOracleParamColl(connection As OracleConnection)
  Dim command As New OracleCommand( _
    "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection)
  Dim paramCollection As OracleParameterCollection = command.Parameters
  Dim parameter As Object = New OracleParameter("pEmpNo", OracleType.Number)
  Dim pIndex As Integer = paramCollection.Add(parameter)
End Sub

適用於

Add(Object)

將指定的 OracleParameter 物件加入至 OracleParameterCollection。

public:
 virtual int Add(System::Object ^ value);

public:
 override int Add(System::Object ^ value);

public int Add (object value);

public override int Add (object value);

abstract member Add : obj -> int
override this.Add : obj -> int

override this.Add : obj -> int

Public Function Add (value As Object) As Integer

Public Overrides Function Add (value As Object) As Integer

參數

value: Object

要新增到集合的 OracleParameter 物件。

傳回

Int32

集合中新 OracleParameter 物件的索引。

實作

Add(Object)

適用於

Add(String, OracleType)

加入 OracleParameter 至提供參數名稱和資料型別的 OracleParameterCollection。

public:
 System::Data::OracleClient::OracleParameter ^ Add(System::String ^ parameterName, System::Data::OracleClient::OracleType dataType);

public System.Data.OracleClient.OracleParameter Add (string parameterName, System.Data.OracleClient.OracleType dataType);

member this.Add : string * System.Data.OracleClient.OracleType -> System.Data.OracleClient.OracleParameter

override this.Add : string * System.Data.OracleClient.OracleType -> System.Data.OracleClient.OracleParameter

Public Function Add (parameterName As String, dataType As OracleType) As OracleParameter

參數

parameterName: String

參數名稱。

dataType: OracleType

其中一個 OracleType 值。

傳回

OracleParameter

新 OracleParameter 物件的參考。

範例

下列範例會 OracleParameterCollection建立、將的 OracleParameter 實例加入至集合，並傳回新 OracleParameter的參考。

public void CreateOracleParamColl() {
    OracleCommand command = new OracleCommand(
        "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection);
    OracleParameterCollection paramCollection = command.Parameters;
    object parameter = new OracleParameter("pEmpNo", OracleType.Number);
    int pIndex = paramCollection.Add(parameter);
 }

Public Sub CreateOracleParamColl(connection As OracleConnection)
  Dim command As New OracleCommand( _
    "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection)
  Dim paramCollection As OracleParameterCollection = command.Parameters
  Dim parameter As Object = New OracleParameter("pEmpNo", OracleType.Number)
  Dim pIndex As Integer = paramCollection.Add(parameter)
End Sub

適用於

Add(String, Object)

警告

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value). http://go.microsoft.com/fwlink/?linkid=14202

加入 OracleParameter 至提供參數名稱和值的 OracleParameterCollection。

public:
 System::Data::OracleClient::OracleParameter ^ Add(System::String ^ parameterName, System::Object ^ value);

public System.Data.OracleClient.OracleParameter Add (string parameterName, object value);

[System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)]
public System.Data.OracleClient.OracleParameter Add (string parameterName, object value);

member this.Add : string * obj -> System.Data.OracleClient.OracleParameter

[<System.Obsolete("Add(String parameterName, Object value) has been deprecated.  Use AddWithValue(String parameterName, Object value).  http://go.microsoft.com/fwlink/?linkid=14202", false)>]
override this.Add : string * obj -> System.Data.OracleClient.OracleParameter

Public Function Add (parameterName As String, value As Object) As OracleParameter

參數

parameterName: String

參數名稱。

value: Object

要加入集合之 OracleParameter 的 Value。

傳回

OracleParameter

新 OracleParameter 物件的參考。

屬性: ObsoleteAttribute

例外狀況

InvalidCastException

value 參數不是 OracleParameter。

備註

使用方法的 Add 這個多載來指定整數參數值時，請小心。由於這個多載接受 Object 型別的 value，因此您必須在值為零時將整數值轉換成 Object 型別，如下面的 C# 範例所示。

parameters.Add("pname", Convert.ToInt32(0));

如果您未執行此轉換，編譯程式會假設您嘗試呼叫 OracleParameterCollection.Add (string， OracleType) 多載。

適用於

Add(String, OracleType, Int32)

將 OracleParameter 加入至提供參數名稱、資料型別和資料行長度的 OracleParameterCollection。

public:
 System::Data::OracleClient::OracleParameter ^ Add(System::String ^ parameterName, System::Data::OracleClient::OracleType dataType, int size);

public System.Data.OracleClient.OracleParameter Add (string parameterName, System.Data.OracleClient.OracleType dataType, int size);

member this.Add : string * System.Data.OracleClient.OracleType * int -> System.Data.OracleClient.OracleParameter

override this.Add : string * System.Data.OracleClient.OracleType * int -> System.Data.OracleClient.OracleParameter

Public Function Add (parameterName As String, dataType As OracleType, size As Integer) As OracleParameter

參數

parameterName: String

參數名稱。

dataType: OracleType

其中一個 OracleType 值。

size: Int32

資料行的長度。

傳回

OracleParameter

新 OracleParameter 物件的參考。

範例

下列範例會 OracleParameterCollection建立、將的 OracleParameter 實例加入至集合，並傳回新 OracleParameter的參考。

public void CreateOracleParamColl(OracleConnection connection)
{
    OracleCommand command = new OracleCommand(
        "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection);
    OracleParameterCollection paramCollection = command.Parameters;
    OracleParameter parameter = paramCollection.Add(
        "pEmpNo", OracleType.Number, 4);
}

Public Sub CreateOracleParamColl(connection As OracleConnection)
  Dim command As New OracleCommand( _
    "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection)
  Dim paramCollection As OracleParameterCollection = command.Parameters
  Dim parameter As OracleParameter = paramCollection.Add( _
    "pEmpNo", OracleType.Number, 4)
End Sub

適用於

Add(String, OracleType, Int32, String)

將 OracleParameter 加入至提供參數名稱、資料型別、資料行長度和來源資料行名稱的 OracleParameterCollection。

public:
 System::Data::OracleClient::OracleParameter ^ Add(System::String ^ parameterName, System::Data::OracleClient::OracleType dataType, int size, System::String ^ srcColumn);

public System.Data.OracleClient.OracleParameter Add (string parameterName, System.Data.OracleClient.OracleType dataType, int size, string srcColumn);

member this.Add : string * System.Data.OracleClient.OracleType * int * string -> System.Data.OracleClient.OracleParameter

override this.Add : string * System.Data.OracleClient.OracleType * int * string -> System.Data.OracleClient.OracleParameter

Public Function Add (parameterName As String, dataType As OracleType, size As Integer, srcColumn As String) As OracleParameter

參數

parameterName: String

參數名稱。

dataType: OracleType

其中一個 OracleType 值。

size: Int32

資料行的長度。

srcColumn: String

來源資料行的名稱。

傳回

OracleParameter

新 OracleParameter 物件的參考。

範例

下列範例會 OracleParameterCollection建立、將的 OracleParameter 實例加入至集合，並傳回新 OracleParameter的參考。

public void CreateOracleParamColl(OracleConnection connection)
{
    OracleCommand command = new OracleCommand(
        "SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection);
    OracleParameterCollection paramCollection = command.Parameters;
    OracleParameter parameter = paramCollection.Add(
        "pEmpNo", OracleType.Number, 5, "EmpNo");
}

Public Sub CreateOracleParamColl(connection As OracleConnection)
  Dim command As OracleCommand = _
    New OracleCommand("SELECT Ename, DeptNo FROM Emp WHERE EmpNo = :pEmpNo", connection)
  Dim paramCollection As OracleParameterCollection = command.Parameters
  Dim parameter As OracleParameter = _
    paramCollection.Add("pEmpNo", OracleType.Number, 5, "EmpNo")
End Sub

適用於

共用方式為

OracleParameterCollection.Add 方法

定義

多載

Add(OracleParameter)

參數

傳回

例外狀況

範例

適用於

Add(Object)

參數

傳回

實作

適用於

Add(String, OracleType)

參數

傳回

範例

適用於

Add(String, Object)

參數

傳回

例外狀況

備註

適用於

Add(String, OracleType, Int32)

參數

傳回

範例

適用於

Add(String, OracleType, Int32, String)

參數

傳回

範例

適用於

其他資源