ObjectParameterCollection.Add(ObjectParameter) 方法

定義

命名空間:
System.Data.Objects
組件:
System.Data.Entity.dll

將指定的 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

要加入集合的參數。

實作

Add(T)

例外狀況

ArgumentNullException

論 parameter 點為 null。

ArgumentException

這個 parameter 論點已經存在於該合集中。 這種行為與大多數允許重複條目的集合不同。

-或-

集合中已有另一個與參數 parameter 同名的參數。 請注意，查詢不區分大小寫。 此行為與大多數集合不同，更接近 Dictionary<TKey,TValue>。

ArgumentOutOfRangeException

的 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。 集合中不能有兩個具有相同名稱的參數。 欲了解更多資訊，請參閱 查詢建構方法。

適用於

另請參閱