SqlParameterCollection.AddWithValue(String, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Dodaje wartość na końcu elementu 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

Parametry

parameterName

String

Nazwa parametru.

value

Object

Wartość do dodania. Użyj Value zamiast wartości null, aby wskazać wartość null.

Zwraca

SqlParameter

Obiekt SqlParameter.

Przykłady

W poniższym przykładzie pokazano, jak używać AddWithValue metody .

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

Uwagi

AddWithValue Zastępuje metodę SqlParameterCollection.Add , która przyjmuje metodę String i Object. Przeciążenie tego Add elementu przyjmuje ciąg i obiekt został przestarzały z powodu możliwej niejednoznaczności z SqlParameterCollection.Add przeciążeniem, które przyjmuje StringSqlDbType wartość i , gdzie przekazywanie liczby całkowitej z ciągiem może być interpretowane jako wartość parametru lub odpowiadająca mu SqlDbType wartość. Użyj AddWithValue polecenia zawsze, gdy chcesz dodać parametr, określając jego nazwę i wartość.

W przypadku SqlDbTypeXml wartości wyliczenia można użyć ciągu, wartości XML, wystąpienia pochodnego XmlReaderSqlXml typu lub obiektu.