SqlCommand.Parameters Propriedade

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Obtém o SqlParameterCollection.

public:
 property System::Data::SqlClient::SqlParameterCollection ^ Parameters { System::Data::SqlClient::SqlParameterCollection ^ get(); };

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

member this.Parameters : System.Data.SqlClient.SqlParameterCollection

Public ReadOnly Property Parameters As SqlParameterCollection

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);
        }
    }
}

Private Sub UpdateDemographics(ByVal customerID As Integer, _
    ByVal demoXml As String, _
    ByVal connectionString As String)

    ' Update the demographics for a store, which is stored 
    ' in an xml column.
    Dim commandText As String = _
     "UPDATE Sales.Store SET Demographics = @demographics " _
     & "WHERE CustomerID = @ID;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(commandText, connection)

        ' Add CustomerID parameter for WHERE clause.
        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()
            Dim rowsAffected As Integer = command.ExecuteNonQuery()
            Console.WriteLine("RowsAffected: {0}", rowsAffected)

        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

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