共用方式為

ObjectParameter 建構函式

  • 參考

定義

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

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

多載

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

如果任何一個引數的值為 null。

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

備註

這個建構函式 (Constructor) 會根據指定的名稱和值來建立參數。 參數的型別是從值推斷的。

當參數加入至 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

參數名稱。 這個名稱不應該包含用在 Entity SQL 陳述式中的 "@" 參數標記，應該只包含實際名稱。 運算式的第一個字元必須是字母。 運算式中的任何後續字元必須是字母、數字或底線 (_) 字元。

type
Type

參數的 Common Language Runtime (CLR) 型別。

例外狀況

ArgumentNullException

如果任何一個引數的值為 null。

ArgumentOutOfRangeException

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

備註

當參數具現化時，就無法變更參數名稱。 您可以透過 Value 屬性設定或變更參數值。 在查詢已經編譯完成之後，您就無法變更此值。 如需詳細資訊，請參閱 查詢產生器方法。

適用於