Ler em inglês

Partilhar via


SqlParameterCollection.AddWithValue(String, Object) Método

Definição

Adiciona um valor ao final do SqlParameterCollection.

public System.Data.SqlClient.SqlParameter AddWithValue (string parameterName, object value);

Parâmetros

parameterName
String

O nome do parâmetro.

value
Object

O valor a ser adicionado. Use Value em vez de nulo para indicar um valor nulo.

Retornos

Um objeto SqlParameter.

Exemplos

O exemplo a seguir demonstra como usar o 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);
        }
    }
}

Comentários

AddWithValue substitui o método SqlParameterCollection.Add que usa um String e um Object. A sobrecarga de Add que usa uma cadeia de caracteres e um objeto foi preterida devido à possível ambiguidade com a sobrecarga SqlParameterCollection.Add que usa um String e um valor de enumeração SqlDbType em que passar um inteiro com a cadeia de caracteres poderia ser interpretado como sendo o valor do parâmetro ou o valor SqlDbType correspondente. Use AddWithValue sempre que quiser adicionar um parâmetro especificando seu nome e valor.

Para SqlDbTypeXml valores de enumeração, você pode usar uma cadeia de caracteres, um valor XML, uma instância de tipo derivado XmlReader ou um objeto SqlXml.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided)
.NET Framework 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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

Confira também