ObjectParameter 建構函式

定義

命名空間:

System.Data.Objects

組件:

System.Data.Entity.dll

初始化 ObjectParameter 類別的新執行個體。

多載

名稱	Description
ObjectParameter(String, Object)	初始化一個以指定名稱與值的新 ObjectParameter 類別實例。
ObjectParameter(String, Type)	初始化一個以指定名稱和型別的新類別實例 ObjectParameter 。

ObjectParameter(String, Object)

初始化一個以指定名稱與值的新 ObjectParameter 類別實例。

public:
 ObjectParameter(System::String ^ name, System::Object ^ value);

public ObjectParameter(string name, object value);

new System.Data.Objects.ObjectParameter : string * obj -> System.Data.Objects.ObjectParameter

Public Sub New (name As String, value As Object)

參數

name

String

參數名稱。 此名稱不應包含實體 SQL 語句中使用的「@」參數標記，僅包含實際名稱。 表達式的第一個字元必須是字母。 表達式中任何後續字元必須是字母、數字或底線（_）字元。

value

Object

參數的初始值（以及本質上的型別）。

例外狀況

ArgumentNullException

若任一參數值為空值。

ArgumentOutOfRangeException

如果名稱參數的值不成立， 參數名稱必須以字母開頭，且只能包含字母、數字和底線。

範例

此範例為集合新增參數。 它會遍歷 並 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;

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

備註

此建構子會根據指定的名稱和值建立參數。 參數的類型是從該值推斷出來的。

加入 後 ObjectParameterCollection，參數名稱無法更改。 參數值可以透過屬性 Value 來更改。 查詢編譯完成後，該值無法更改。 欲了解更多資訊，請參閱 查詢建構方法。

另請參閱

• 以物件形式查詢資料並塑造結果（實體框架）

ObjectParameter(String, Type)

初始化一個以指定名稱和型別的新類別實例 ObjectParameter 。

public:
 ObjectParameter(System::String ^ name, Type ^ type);

public ObjectParameter(string name, Type type);

new System.Data.Objects.ObjectParameter : string * Type -> System.Data.Objects.ObjectParameter

Public Sub New (name As String, type As Type)

參數

name

String

參數名稱。 此名稱不應包含實體 SQL 語句中使用的「@」參數標記，僅包含實際名稱。 表達式的第一個字元必須是字母。 表達式中任何後續字元必須是字母、數字或底線（_）字元。

type

Type

參數的共通語言執行時（CLR）型態。

例外狀況

ArgumentNullException

若任一參數值為空值。

ArgumentOutOfRangeException

如果名稱參數的值無效， 參數名稱必須以字母開頭，且只能包含字母、數字和底線。

備註

實例化後，參數名稱無法更改。 參數值可以透過屬性 Value 設定或更改。 查詢編譯完成後，該值無法更改。 欲了解更多資訊，請參閱 查詢建構方法。