Partilhar via


OracleParameterCollection.Add Método

Definição

Sobrecargas

Add(OracleParameter)

Adiciona o OracleParameter especificado ao OracleParameterCollection.

Add(Object)

Adiciona o objeto OracleParameter especificado ao OracleParameterCollection.

Add(String, OracleType)

Adiciona um OracleParameter ao OracleParameterCollection, dado o nome do parâmetro o tipo de dados.

Add(String, Object)
Obsoleto.

Adiciona um OracleParameter ao OracleParameterCollection dado o nome e o valor do parâmetro.

Add(String, OracleType, Int32)

Adiciona um OracleParameter ao OracleParameterCollection dado o nome do parâmetro, o tipo de dados e o comprimento da coluna.

Add(String, OracleType, Int32, String)

Adiciona um OracleParameter ao OracleParameterCollection, considerando o nome de parâmetro, tipo de dados, tamanho da coluna e nome da coluna de origem.

Add(OracleParameter)

Adiciona o OracleParameter especificado ao 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

Parâmetros

value
OracleParameter

O OracleParameter a adicionar à coleção.

Retornos

Uma referência ao objeto OracleParameter.

Exceções

O OracleParameter especificado no parâmetro value já foi adicionado a este ou a outro OracleParameterCollection.

O parâmetro value é nulo.

Exemplos

O exemplo a seguir cria um OracleParameterCollection, adiciona instâncias de OracleParameter à coleção e retorna uma referência ao novo 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

Aplica-se a

Add(Object)

Adiciona o objeto OracleParameter especificado ao 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

Parâmetros

value
Object

O objeto OracleParameter a ser adicionado à coleção.

Retornos

O índice do novo objeto OracleParameter na coleção.

Implementações

Aplica-se a

Add(String, OracleType)

Adiciona um OracleParameter ao OracleParameterCollection, dado o nome do parâmetro o tipo de dados.

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

Parâmetros

parameterName
String

O nome do parâmetro.

dataType
OracleType

Um dos valores de OracleType.

Retornos

Uma referência ao objeto OracleParameter.

Exemplos

O exemplo a seguir cria um OracleParameterCollection, adiciona instâncias de OracleParameter à coleção e retorna uma referência ao novo 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

Aplica-se a

Add(String, Object)

Cuidado

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

Adiciona um OracleParameter ao OracleParameterCollection dado o nome e o valor do parâmetro.

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

Parâmetros

parameterName
String

O nome do parâmetro.

value
Object

O Value do OracleParameter para adicionar à coleção.

Retornos

Uma referência ao objeto OracleParameter.

Atributos

Exceções

O parâmetro value não é um OracleParameter.

Comentários

Tenha cuidado ao usar essa sobrecarga do Add método para especificar valores de parâmetro inteiros. Como essa sobrecarga toma um value do tipo Object, você deve converter o valor integral em um tipo Object quando o valor for zero, como demonstra o exemplo C# a seguir.

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

Se você não executar essa conversão, o compilador assumirá que você está tentando chamar a OracleParameterCollection.Add sobrecarga (string, OracleType) .

Aplica-se a

Add(String, OracleType, Int32)

Adiciona um OracleParameter ao OracleParameterCollection dado o nome do parâmetro, o tipo de dados e o comprimento da coluna.

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

Parâmetros

parameterName
String

O nome do parâmetro.

dataType
OracleType

Um dos valores de OracleType.

size
Int32

O comprimento da coluna.

Retornos

Uma referência ao objeto OracleParameter.

Exemplos

O exemplo a seguir cria um OracleParameterCollection, adiciona uma instância de OracleParameter à coleção e retorna uma referência ao novo 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

Aplica-se a

Add(String, OracleType, Int32, String)

Adiciona um OracleParameter ao OracleParameterCollection, considerando o nome de parâmetro, tipo de dados, tamanho da coluna e nome da coluna de origem.

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

Parâmetros

parameterName
String

O nome do parâmetro.

dataType
OracleType

Um dos valores de OracleType.

size
Int32

O comprimento da coluna.

srcColumn
String

O nome da coluna de origem.

Retornos

Uma referência ao objeto OracleParameter.

Exemplos

O exemplo a seguir cria um OracleParameterCollection, adiciona uma instância de OracleParameter à coleção e retorna uma referência ao novo 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

Aplica-se a