OdbcParameterCollection.Add Método

Definição

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacote:

System.Data.Odbc v8.0.0

Adiciona um OdbcParameter em uma OdbcParameterCollection.

Sobrecargas

Add(OdbcParameter)	Adiciona o OdbcParameter especificado ao OdbcParameterCollection.
Add(Object)	Adiciona o objeto OdbcParameter especificado ao OdbcParameterCollection.
Add(String, OdbcType)	Adiciona um OdbcParameter ao OdbcParameterCollection, dado o nome do parâmetro o tipo de dados.
Add(String, Object)	Obsoleto. Adiciona um OdbcParameter ao OdbcParameterCollection dado o nome e o valor do parâmetro.
Add(String, OdbcType, Int32)	Adiciona um OdbcParameter ao OdbcParameterCollection dado o nome do parâmetro, o tipo de dados e o comprimento da coluna.
Add(String, OdbcType, Int32, String)	Adiciona um OdbcParameter ao OdbcParameterCollection, considerando o nome de parâmetro, tipo de dados, tamanho da coluna e nome da coluna de origem.

Add(OdbcParameter)

Origem:

OdbcParameterCollection.cs

Adiciona o OdbcParameter especificado ao OdbcParameterCollection.

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::Data::Odbc::OdbcParameter ^ value);

public System.Data.Odbc.OdbcParameter Add (System.Data.Odbc.OdbcParameter value);

override this.Add : System.Data.Odbc.OdbcParameter -> System.Data.Odbc.OdbcParameter

Public Function Add (value As OdbcParameter) As OdbcParameter

Parâmetros

value

OdbcParameter

O OdbcParameter a adicionar à coleção.

Retornos

OdbcParameter

O índice do novo objeto OdbcParameter.

Exceções

ArgumentException

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

ArgumentNullException

O parâmetro value é nulo.

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter

Add(Object)

Origem:

OdbcParameterCollectionHelper.cs

Adiciona o objeto OdbcParameter especificado ao OdbcParameterCollection.

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

public override int Add (object value);

override this.Add : obj -> int

Public Overrides Function Add (value As Object) As Integer

Parâmetros

value

Object

Uma Object.

Retornos

Int32

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

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter

Add(String, OdbcType)

Origem:

OdbcParameterCollection.cs

Adiciona um OdbcParameter ao OdbcParameterCollection, dado o nome do parâmetro o tipo de dados.

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Data::Odbc::OdbcType odbcType);

public System.Data.Odbc.OdbcParameter Add (string? parameterName, System.Data.Odbc.OdbcType odbcType);

override this.Add : string * System.Data.Odbc.OdbcType -> System.Data.Odbc.OdbcParameter

Public Function Add (parameterName As String, odbcType As OdbcType) As OdbcParameter

Parâmetros

parameterName

String

O nome do parâmetro.

odbcType

OdbcType

Um dos valores de OdbcType.

Retornos

OdbcParameter

O índice do novo objeto OdbcParameter.

Exemplos

O exemplo a Parameters seguir adiciona um OdbcParameter à coleção.

public void CreateParamCollection()
{
    OdbcCommand command = new OdbcCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OdbcParameterCollection paramCollection = command.Parameters;
    object paramObject = new OdbcParameter(
        "CustomerID", OdbcType.VarChar);
    int paramIndex = paramCollection.Add(paramObject);
}

Public Sub CreateParamCollection(connection As OdbcConnection)
  Dim command As New OdbcCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OdbcParameterCollection = command.Parameters
  Dim paramObject As Object = New OdbcParameter( _
    "CustomerID", OdbcType.VarChar)
  Dim paramIndex As Integer = paramCollection.Add(paramObject)
End Sub

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter

Add(String, Object)

Origem:

OdbcParameterCollection.cs

Cuidado

Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.

Adiciona um OdbcParameter ao OdbcParameterCollection dado o nome e o valor do parâmetro.

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Object ^ value);

[System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.")]
public System.Data.Odbc.OdbcParameter Add (string? parameterName, object? value);

[<System.Obsolete("Add(String parameterName, Object value) has been deprecated. Use AddWithValue(String parameterName, Object value) instead.")>]
override this.Add : string * obj -> System.Data.Odbc.OdbcParameter

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

Parâmetros

parameterName

String

O nome do parâmetro.

value

Object

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

Retornos

OdbcParameter

O índice do novo objeto OdbcParameter.

Atributos

ObsoleteAttribute

Exceções

InvalidCastException

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

Comentários

Tenha cuidado ao usar essa sobrecarga do Add método para especificar valores de parâmetro inteiros. Como essa sobrecarga usa um value tipo Object, você deve converter o valor inteiro em um Object tipo quando o valor for zero, como demonstra o exemplo de 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 OdbcParameterCollection.Add sobrecarga.

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter

Add(String, OdbcType, Int32)

Origem:

OdbcParameterCollection.cs

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

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Data::Odbc::OdbcType odbcType, int size);

public System.Data.Odbc.OdbcParameter Add (string? parameterName, System.Data.Odbc.OdbcType odbcType, int size);

override this.Add : string * System.Data.Odbc.OdbcType * int -> System.Data.Odbc.OdbcParameter

Public Function Add (parameterName As String, odbcType As OdbcType, size As Integer) As OdbcParameter

Parâmetros

parameterName

String

O nome do parâmetro.

odbcType

OdbcType

Um dos valores de OdbcType.

size

Int32

O comprimento da coluna.

Retornos

OdbcParameter

O índice do novo objeto OdbcParameter.

Exemplos

O exemplo a OdbcCommand.Parameters seguir adiciona um OdbcParameter à coleção.

public void CreateOdbcParamColl(OdbcConnection connection)
{
    OdbcCommand command = new OdbcCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OdbcParameterCollection paramCollection = command.Parameters;
    OdbcParameter parameter = paramCollection.Add(
        "CustomerID", OdbcType.VarChar, 5);
}

Public Sub CreateOdbcParamColl(connection As OdbcConnection)
  Dim command As New OdbcCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OdbcParameterCollection = _
    command.Parameters
  Dim parameter As OdbcParameter = _
    paramCollection.Add("CustomerID", OdbcType.VarChar, 5)
End Sub

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter

Add(String, OdbcType, Int32, String)

Origem:

OdbcParameterCollection.cs

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

public:
 System::Data::Odbc::OdbcParameter ^ Add(System::String ^ parameterName, System::Data::Odbc::OdbcType odbcType, int size, System::String ^ sourceColumn);

public System.Data.Odbc.OdbcParameter Add (string? parameterName, System.Data.Odbc.OdbcType odbcType, int size, string? sourceColumn);

override this.Add : string * System.Data.Odbc.OdbcType * int * string -> System.Data.Odbc.OdbcParameter

Public Function Add (parameterName As String, odbcType As OdbcType, size As Integer, sourceColumn As String) As OdbcParameter

Parâmetros

parameterName

String

O nome do parâmetro.

odbcType

OdbcType

Um dos valores de OdbcType.

size

Int32

O comprimento da coluna.

sourceColumn

String

O nome da coluna de origem.

Retornos

OdbcParameter

O índice do novo objeto OdbcParameter.

Exemplos

O exemplo a Parameters seguir adiciona um OdbcParameter à coleção.

public void CreateParameterCollection(OdbcConnection connection)
{
    OdbcCommand command = new OdbcCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OdbcParameterCollection paramCollection = command.Parameters;
    OdbcParameter parameter = paramCollection.Add(
        "CustomerID", OdbcType.VarChar, 5, "CustomerID");
}

Public Sub CreateParameterCollection(connection As OdbcConnection)
  Dim command As New OdbcCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OdbcParameterCollection = command.Parameters
  Dim parameter As OdbcParameter = paramCollection.Add( _
    "CustomerID", OdbcType.VarChar, 5, "CustomerID")
End Sub

Confira também

• Trabalhando com comandos
• Usando parâmetros com um DataAdapter