OracleParameterCollection.Add Método

Referência

Definição

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona um OracleParameter ao OracleParameterCollection.

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

OracleParameter

Uma referência ao objeto OracleParameter.

Exceções

ArgumentException

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

ArgumentNullException

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

Int32

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

Implementações

Add(Object)

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

OracleParameter

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

OracleParameter

Uma referência ao objeto OracleParameter.

Atributos: ObsoleteAttribute

Exceções

InvalidCastException

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

OracleParameter

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

OracleParameter

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

OracleParameterCollection.Add Método

Definição

Sobrecargas

Add(OracleParameter)

Parâmetros

Retornos

Exceções

Exemplos

Aplica-se a

Add(Object)

Parâmetros

Retornos

Implementações

Aplica-se a

Add(String, OracleType)

Parâmetros

Retornos

Exemplos

Aplica-se a

Add(String, Object)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Add(String, OracleType, Int32)

Parâmetros

Retornos

Exemplos

Aplica-se a

Add(String, OracleType, Int32, String)

Parâmetros

Retornos

Exemplos

Aplica-se a

Comentários

Recursos adicionais