SqlParameterCollection.AddWithValue(String, Object) Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

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

public:
 Microsoft::Data::SqlClient::SqlParameter ^ AddWithValue(System::String ^ parameterName, System::Object ^ value);

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

member this.AddWithValue : string * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Function AddWithValue (parameterName As String, value As Object) As SqlParameter

Parámetros

parameterName

String

El nombre del parámetro.

value

Object

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

Devoluciones

SqlParameter

Un objeto SqlParameter.

Ejemplos

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

using System;
using System.Data;
using Microsoft.Data.SqlClient;


class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        string demo = @"<StoreSurvey xmlns=""http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/StoreSurvey""><AnnualSales>1500000</AnnualSales><AnnualRevenue>150000</AnnualRevenue><BankName>Primary International</BankName><BusinessType>OS</BusinessType><YearOpened>1974</YearOpened><Specialty>Road</Specialty><SquareFeet>38000</SquareFeet><Brands>3</Brands><Internet>DSL</Internet><NumberEmployees>40</NumberEmployees></StoreSurvey>";
        Int32 id = 3;
        UpdateDemographics(id, demo, connectionString);
        Console.ReadLine();
    }
    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

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

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