SqlCommand.Parameters Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.0.1

SqlParameterCollectionMendapatkan .

public:
 property Microsoft::Data::SqlClient::SqlParameterCollection ^ Parameters { Microsoft::Data::SqlClient::SqlParameterCollection ^ get(); };

public Microsoft.Data.SqlClient.SqlParameterCollection Parameters { get; }

member this.Parameters : Microsoft.Data.SqlClient.SqlParameterCollection

Public ReadOnly Property Parameters As SqlParameterCollection

Nilai Properti

SqlParameterCollection

Parameter pernyataan Transact-SQL atau prosedur tersimpan. Defaultnya adalah koleksi kosong.

Contoh

Contoh berikut menunjukkan cara membuat SqlCommand dan menambahkan parameter ke SqlParameterCollection.

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);
            }
        }
    }
    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI";
    }
}

Keterangan

Data Provider Microsoft .NET Framework untuk SQL Server tidak mendukung tempat penampung tanda tanya (?) untuk meneruskan parameter ke Pernyataan SQL atau prosedur tersimpan yang disebut oleh perintah CommandType.Text. Dalam hal ini, parameter bernama harus digunakan. Contohnya:

SELECT * FROM Customers WHERE CustomerID = @CustomerID

Nota

Jika parameter dalam koleksi tidak cocok dengan persyaratan kueri yang akan dijalankan, kesalahan dapat mengakibatkan kesalahan.

Untuk informasi selengkapnya, lihat Mengonfigurasi parameter.