OleDbParameterCollection.Add Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-preview.3.24172.9

Adiciona um OleDbParameter em uma OleDbParameterCollection.

Sobrecargas

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

Add(OleDbParameter)

Origem:

OleDbParameterCollection.cs

Adiciona o OleDbParameter especificado ao OleDbParameterCollection.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::Data::OleDb::OleDbParameter ^ value);

public System.Data.OleDb.OleDbParameter Add (System.Data.OleDb.OleDbParameter value);

override this.Add : System.Data.OleDb.OleDbParameter -> System.Data.OleDb.OleDbParameter

Public Function Add (value As OleDbParameter) As OleDbParameter

Parâmetros

value

OleDbParameter

O OleDbParameter a adicionar à coleção.

Retornos

OleDbParameter

O índice do novo objeto OleDbParameter.

Exceções

ArgumentException

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

ArgumentNullException

O parâmetro value é nulo.

Exemplos

O exemplo a seguir cria um OleDbParameterCollection e adiciona um OleDbParameter.

public void CreateParameters()
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter myParm = paramCollection.Add(
        new OleDbParameter("CustomerID", OleDbType.VarChar));
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim myParm As OleDbParameter = paramCollection.Add( _
    New OleDbParameter("CustomerID", OleDbType.VarChar))
End Sub

Confira também

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

Add(Object)

Origem:

OleDbParameterCollectionHelper.cs

Adiciona o objeto OleDbParameter especificado ao OleDbParameterCollection.

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 OleDbParameter na coleção.

Confira também

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

Add(String, OleDbType)

Origem:

OleDbParameterCollection.cs

Adiciona um OleDbParameter ao OleDbParameterCollection, dado o nome do parâmetro o tipo de dados.

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType);

public System.Data.OleDb.OleDbParameter Add (string? parameterName, System.Data.OleDb.OleDbType oleDbType);

override this.Add : string * System.Data.OleDb.OleDbType -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, oleDbType As OleDbType) As OleDbParameter

Parâmetros

parameterName

String

O nome do parâmetro.

oleDbType

OleDbType

Um dos valores de OleDbType.

Retornos

OleDbParameter

O índice do novo objeto OleDbParameter.

Exemplos

O exemplo a seguir cria um OleDbParameterCollection e adiciona um OleDbParameter.

public void CreateParameters()
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter myParm = paramCollection.Add(
        "CustomerID", OleDbType.VarChar);
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim myParm As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar)
End Sub

Confira também

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

Add(String, Object)

Origem:

OleDbParameterCollection.cs

Cuidado

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

Adiciona um OleDbParameter ao OleDbParameterCollection dado o nome e o valor do parâmetro.

public:
 System::Data::OleDb::OleDbParameter ^ 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.OleDb.OleDbParameter 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.OleDb.OleDbParameter

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

Parâmetros

parameterName

String

O nome do parâmetro.

value

Object

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

Retornos

OleDbParameter

O índice do novo objeto OleDbParameter.

Atributos

ObsoleteAttribute

Exceções

InvalidCastException

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

Comentários

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

Confira também

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

Add(String, OleDbType, Int32)

Origem:

OleDbParameterCollection.cs

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

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType, int size);

public System.Data.OleDb.OleDbParameter Add (string? parameterName, System.Data.OleDb.OleDbType oleDbType, int size);

override this.Add : string * System.Data.OleDb.OleDbType * int -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, oleDbType As OleDbType, size As Integer) As OleDbParameter

Parâmetros

parameterName

String

O nome do parâmetro.

oleDbType

OleDbType

Um dos valores de OleDbType.

size

Int32

O comprimento da coluna.

Retornos

OleDbParameter

O índice do novo objeto OleDbParameter.

Exemplos

O exemplo a seguir cria um OleDbParameterCollection, adiciona uma instância de OleDbParameter à coleção e retorna uma referência ao novo OleDbParameter.

public void CreateParameters(OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter parameter = paramCollection.Add(
        "CustomerID", OleDbType.VarChar, 5);
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim parameter As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar, 5)
End Sub

Confira também

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

Add(String, OleDbType, Int32, String)

Origem:

OleDbParameterCollection.cs

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

public:
 System::Data::OleDb::OleDbParameter ^ Add(System::String ^ parameterName, System::Data::OleDb::OleDbType oleDbType, int size, System::String ^ sourceColumn);

public System.Data.OleDb.OleDbParameter Add (string? parameterName, System.Data.OleDb.OleDbType oleDbType, int size, string? sourceColumn);

override this.Add : string * System.Data.OleDb.OleDbType * int * string -> System.Data.OleDb.OleDbParameter

Public Function Add (parameterName As String, oleDbType As OleDbType, size As Integer, sourceColumn As String) As OleDbParameter

Parâmetros

parameterName

String

O nome do parâmetro.

oleDbType

OleDbType

Um dos valores de OleDbType.

size

Int32

O comprimento da coluna.

sourceColumn

String

O nome da coluna de origem.

Retornos

OleDbParameter

O índice do novo objeto OleDbParameter.

Exemplos

O exemplo a seguir cria um OleDbParameterCollection, adiciona uma instância de OleDbParameter à coleção e retorna uma referência ao novo OleDbParameter.

public void CreateParameters(OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(
        "SELECT * FROM Customers WHERE CustomerID = ?", connection);
    OleDbParameterCollection paramCollection = command.Parameters;
    OleDbParameter parameter = paramCollection.Add(
        "CustomerID", OleDbType.VarChar, 5, "CustomerID");
}

Public Sub CreateParameters(connection As OleDbConnection)
  Dim command As New OleDbCommand( _
    "SELECT * FROM Customers WHERE CustomerID = ?", connection)
  Dim paramCollection As OleDbParameterCollection = command.Parameters
  Dim parameter As OleDbParameter = paramCollection.Add( _
    "CustomerID", OleDbType.VarChar, 5, "CustomerID")
End Sub

Confira também

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