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 中必須是唯一的。 集合中不能有兩個參數同名。 如需詳細資訊，請參閱 查詢產生器方法。

另請參閱

• (Entity Framework) 查詢數據作為物件和成形結果