Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método SqlParameterCollection.AddWithValue (String, Object)

 

Publicado: noviembre de 2016

Agrega un valor al final de la colección SqlParameterCollection.

Espacio de nombres:   System.Data.SqlClient
Ensamblado:  System.Data (en System.Data.dll)

public SqlParameter AddWithValue(
	string parameterName,
	object value
)

Parámetros

parameterName
Type: System.String

Nombre del parámetro.

value
Type: System.Object

Valor que se va a agregar. Use DBNull.Value en lugar de null para indicar un valor null.

AddWithValue reemplaza el SqlParameterCollection.Add método que toma un String y un Object. La sobrecarga de Add que toma una cadena y un objeto ha quedado obsoleta debido a la posible ambigüedad con la SqlParameterCollection.Add sobrecarga que toma un String y un SqlDbType donde pasar un entero con la cadena se interpreta como el valor del parámetro o el correspondiente valor de la enumeración SqlDbType valor. Use AddWithValue siempre que desee agregar un parámetro especificando su nombre y valor.

Para SqlDbTypeXml valores de enumeración, puede usar una cadena, un valor XML, una XmlReader derivados de la instancia de tipo, o un SqlXml objeto.

En el siguiente ejemplo se muestra cómo se utiliza el método AddWithValue.

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

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: