Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

SqlParameterCollection.AddWithValue (Método)

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
Tipo: System.String
Nombre del parámetro.
value
Tipo: System.Object
Valor que se va a agregar. Use DBNull.Value en lugar de null para indicar un valor null.

Valor devuelto

Tipo: System.Data.SqlClient.SqlParameter
Un objeto SqlParameter.

AddWithValue reemplaza el método SqlParameterCollection.Add que toma String y Object. La sobrecarga de Add que toma una cadena y un objeto ha quedado obsoleto por la posible ambigüedad con la sobrecarga de SqlParameterCollection.Add que toma un objeto String y un valor de enumeración SqlDbType, ya que el paso de un entero con la cadena podía interpretarse como el paso del valor de parámetro o el valor de SqlDbType correspondiente. Debe utilizarse AddWithValue siempre que se desee agregar un parámetro especificando su nombre y valor.

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

En el siguiente ejemplo se muestra cómo utilizar 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

Compatible con: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft