共用方式為


ObjectParameterCollection.Add(ObjectParameter) 方法

定義

將指定的 ObjectParameter 加入至集合。

public:
 virtual void Add(System::Data::Objects::ObjectParameter ^ parameter);
public void Add (System.Data.Objects.ObjectParameter parameter);
abstract member Add : System.Data.Objects.ObjectParameter -> unit
override this.Add : System.Data.Objects.ObjectParameter -> unit
Public Sub Add (parameter As ObjectParameter)

參數

parameter
ObjectParameter

要加入至集合的參數。

實作

例外狀況

parameter 引數為 null

parameter 引數已存在此集合中。 這個行為與大部分允許重複項目之集合的行為不同。

-或-

集合中已經有另一個與 parameter 引數具有相同名稱的參數。 請注意,查閱不區分大小寫。 這個行為與大部分集合的行為不同,而且比較類似 Dictionary<TKey,TValue> 的行為。

parameter 的型別無效。

範例

這個範例會將新的參數新增至集合。 它會逐一查看 ObjectParameterCollection 並顯示集合中每個參數的名稱、型別和值。

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE contact FROM AdventureWorksEntities.Contacts
        AS contact WHERE contact.LastName = @ln AND contact.FirstName = @fn";

    ObjectQuery<Contact> contactQuery =
        new ObjectQuery<Contact>(queryString, context);

    // Add parameters to the collection.
    contactQuery.Parameters.Add(new ObjectParameter("ln", "Adams"));
    contactQuery.Parameters.Add(new ObjectParameter("fn", "Frances"));

    ObjectParameterCollection objectParameterCollection =
        contactQuery.Parameters;

    Console.WriteLine("Count is {0}.", objectParameterCollection.Count);

    // Iterate through the ObjectParameterCollection collection.
    foreach (ObjectParameter result in objectParameterCollection)
    {
        Console.WriteLine("{0} {1} {2}", result.Name,
            result.Value,
            result.ParameterType);
    }
}

備註

加入參數之後,只要尚未編譯或執行查詢,就可以從集合中移除參數,而且可以清除此集合。 參數名稱無法變更,但是參數值則可以隨時變更。

參數在 ObjectParameterCollection 中必須是唯一的。 集合中不能有兩個參數同名。 如需詳細資訊,請參閱 查詢產生器方法

適用於

另請參閱