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

パラメーター名。 この名前には、Entity SQL ステートメントで使用される "@" パラメーター マーカーを含めず、実際の名前のみを含める必要があります。 式の先頭の文字は、英字にする必要があります。 式の 2 番目以降の文字には、英字、数字、アンダースコア (_) のいずれかを使用してください。

value
Object

パラメーターの初期値 (本質的には型)。

例外

ArgumentNullException

いずれかの引数の値が NULL の場合。

ArgumentOutOfRangeException

name 引数の値が無効の場合。 パラメーター名は、先頭を英字にする必要があり、英字、数字、およびアンダースコアのみを含めることができます。

例

次の使用例は、新しいパラメーターをコレクションに追加します。 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 プロパティを使用して変更できます。 クエリがコンパイルされた後は、値を変更できません。 詳細については、「 Query Builder メソッド」を参照してください。

こちらもご覧ください

適用対象

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 ステートメントで使用される "@" パラメーター マーカーは含めないでください。実際の名前だけにする必要があります。 式の先頭の文字は、英字にする必要があります。 式の 2 番目以降の文字には、英字、数字、アンダースコア (_) のいずれかを使用してください。

type
Type

パラメーターの共通言語ランタイム (CLR) 型。

例外

ArgumentNullException

いずれかの引数の値が NULL の場合。

ArgumentOutOfRangeException

name 引数の値が無効の場合。 パラメーター名は、先頭を英字にする必要があり、英字、数字、およびアンダースコアのみを含めることができます。

注釈

インスタンス化されたパラメーターの名前は変更できません。 パラメーター値は、Value プロパティを使用して設定または変更できます。 クエリがコンパイルされた後は、値を変更できません。 詳細については、「 Query Builder メソッド」を参照してください。

適用対象