Leer en inglés

Compartir a través de


SqlCommand.Parameters Propiedad

Definición

Obtiene la estructura SqlParameterCollection.

public System.Data.SqlClient.SqlParameterCollection Parameters { get; }
[System.Data.DataSysDescription("DbCommand_Parameters")]
public System.Data.SqlClient.SqlParameterCollection Parameters { get; }

Valor de propiedad

Parámetros del procedimiento almacenado o instrucción de Transact-SQL. El valor predeterminado es una colección vacía.

Atributos

Ejemplos

En el ejemplo siguiente se muestra cómo crear y SqlCommand agregar parámetros a 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);
        }
    }
}

Comentarios

El proveedor de datos de Microsoft .NET Framework para SQL Server no admite el marcador de posición de signo de interrogación (?) para pasar parámetros a una instrucción SQL o a un procedimiento almacenado llamado por un comando de CommandType.Text. En este caso, se deben usar parámetros con nombre. Por ejemplo:

SELECT * FROM Customers WHERE CustomerID = @CustomerID

Nota

Si los parámetros de la colección no coinciden con los requisitos de la consulta que se van a ejecutar, puede producirse un error.

Para obtener más información, consulte Configuración de parámetros y tipos de datos de parámetros.

Se aplica a

Producto Versiones
.NET Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Consulte también