OleDbCommand.Parameters Propriedade

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-rc.2.24473.5

Obtém o OleDbParameterCollection.

public:
 property System::Data::OleDb::OleDbParameterCollection ^ Parameters { System::Data::OleDb::OleDbParameterCollection ^ get(); };

public System.Data.OleDb.OleDbParameterCollection Parameters { get; }

member this.Parameters : System.Data.OleDb.OleDbParameterCollection

Public ReadOnly Property Parameters As OleDbParameterCollection

Valor da propriedade

OleDbParameterCollection

Os parâmetros da instrução SQL ou do procedimento armazenado. O padrão é uma coleção vazia.

Exemplos

O exemplo a seguir cria um OleDbCommand e exibe seus parâmetros. Para fazer isso, o método é passado um OleDbConnection, uma cadeia de caracteres de consulta que é uma instrução SQL SELECT e uma matriz de OleDbParameter objetos.

public void CreateMyOleDbCommand(OleDbConnection connection,
    string queryString, OleDbParameter[] parameters)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.CommandText =
        "SELECT CustomerID, CompanyName FROM Customers WHERE Country = ? AND City = ?";
    command.Parameters.Add(parameters);

    for (int j=0; j<parameters.Length; j++)
    {
        command.Parameters.Add(parameters[j]) ;
    }

    string message = "";
    for (int i = 0; i < command.Parameters.Count; i++)
    {
        message += command.Parameters[i].ToString() + "\n";
    }
    Console.WriteLine(message);
}

 Public Sub CreateMyOleDbCommand(connection As OleDbConnection, _
   queryString As String, parameters() As OleDbParameter)

    Dim command As New OleDbCommand(queryString, connection)
    command.CommandText = _
       "SELECT CustomerID, CompanyName FROM Customers WHERE Country = ? AND City = ?"
    command.Parameters.Add(parameters)

    Dim j As Integer
    For j = 0 To command.Parameters.Count - 1
       command.Parameters.Add(parameters(j))
    Next j

    Dim message As String = ""
    Dim i As Integer
    For i = 0 To command.Parameters.Count - 1
        message += command.Parameters(i).ToString() + ControlChars.Cr
    Next i
    Console.WriteLine(message)
End Sub

Comentários

O Provedor .NET do OLE DB não dá suporte a parâmetros nomeados para passar parâmetros para uma instrução SQL ou um procedimento armazenado chamado por um OleDbCommand quando CommandType é definido Textcomo . Nesse caso, o espaço reservado do ponto de interrogação (?) deve ser usado. Por exemplo:

SELECT * FROM Customers WHERE CustomerID = ?

Portanto, a ordem na qual OleDbParameter os objetos são adicionados ao OleDbParameterCollection deve corresponder diretamente à posição do espaço reservado do ponto de interrogação para o parâmetro no texto de comando.

Observação

Se os parâmetros na coleção não corresponderem aos requisitos da consulta a ser executada, um erro poderá resultar.

Para obter mais informações, consulte Configurando parâmetros e tipos de dados de parâmetro.

Confira também

• Trabalhando com comandos