SqlCommand.Parameters 屬性

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.9.0

來源:

System.Data.SqlClient.notsupported.cs

取得 SqlParameterCollection。

C#

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

屬性值

SqlParameterCollection

Transact-SQL 陳述式或預存程序的參數。 預設為空集合。

範例

下列範例示範如何建立 SqlCommand ，並將參數新增至 SqlParameterCollection。

C#

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

備註

Microsoft .NET Framework data Provider for SQL Server 不支援問號 (？) 占位符，將參數傳遞至 SQL 語句或 命令CommandType.Text所呼叫的預存程式。 在此情況下，必須使用具名參數。 例如：

SELECT * FROM Customers WHERE CustomerID = @CustomerID

注意

如果集合中的參數不符合要執行之查詢的需求，可能會產生錯誤。

如需詳細資訊，請參閱 設定參數和參數數據類型。

另請參閱

• 連接和擷取 ADO.NET 中的數據
• 使用 .NET Framework Data Provider for SQL Server
• ADO.NET 概觀 $\mathrm{部}\mathrm{分}\mathrm{機}\mathrm{器}\mathrm{翻}\mathrm{譯}$