SqlCommand.Parameters Propriedade

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.9.0

Origem:

System.Data.SqlClient.notsupported.cs

Obtém o SqlParameterCollection.

public System.Data.SqlClient.SqlParameterCollection Parameters { get; }

Valor da propriedade

SqlParameterCollection

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

Exemplos

O exemplo a seguir demonstra como criar um SqlCommand e adicionar parâmetros ao SqlParameterCollection.

private static void UpdateDemographics(Int32 customerID,
    string demoXml, string connectionString)
{
    // Update the demographics for a store, which is stored
    // in an xml column.
    string commandText = "UPDATE Sales.Store SET Demographics = @demographics "
        + "WHERE CustomerID = @ID;";

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlCommand command = new SqlCommand(commandText, connection);
        command.Parameters.Add("@ID", SqlDbType.Int);
        command.Parameters["@ID"].Value = customerID;

        // Use AddWithValue to assign Demographics.
        // SQL Server will implicitly convert strings into XML.
        command.Parameters.AddWithValue("@demographics", demoXml);

        try
        {
            connection.Open();
            Int32 rowsAffected = command.ExecuteNonQuery();
            Console.WriteLine("RowsAffected: {0}", rowsAffected);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Comentários

O Provedor de Dados do Microsoft .NET Framework para SQL Server não dá suporte ao espaço reservado de ponto de interrogação (?) para passar parâmetros para uma Instrução SQL ou um procedimento armazenado chamado por um comando de CommandType.Text. Nesse caso, os parâmetros nomeados devem ser usados. Por exemplo:

SELECT * FROM Customers WHERE CustomerID = @CustomerID

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

• Conectando e recuperando dados em ADO.NET
• Usando o provedor de dados .NET Framework para SQL Server
• Visão geral do ADO.NET