SqlParameterCollection.AddWithValue(String, Object) Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

sonuna SqlParameterCollectionbir değer ekler.

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

Parametreler

parameterName

String

Parametrenin adı.

value

Object

Eklenecek değer. Null değerini belirtmek için null yerine kullanın Value .

Döndürülenler

SqlParameter

Bir SqlParameter nesnesi.

Örnekler

Aşağıdaki örnekte yönteminin nasıl kullanılacağı gösterilmektedir 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);
            }
        }
    }

Açıklamalar

AddWithValue SqlParameterCollection.Add, ve Objectalan yönteminin yerini alırString. Bunun aşırı yüklemesi Add bir dize alır ve bir nesnesi, bir tamsayıyı dizeyle geçirmenin parametre değeri veya karşılık gelen SqlDbType değer olarak yorumlanabileceği bir SqlDbType ve numaralandırma değeri alan String aşırı yükleme ile SqlParameterCollection.Add olası belirsizlik nedeniyle kullanım dışı bırakıldı. Adını ve değerini belirterek parametre eklemek istediğiniz her zaman kullanın AddWithValue .

Numaralandırma değerleri için SqlDbTypeXml dize, XML değeri, türetilmiş tür XmlReader örneği veya nesne SqlXml kullanabilirsiniz.