ObjectParameterCollection.Add(ObjectParameter) Metode

Definisi

Ruang nama:

System.Data.Objects

Rakitan:

System.Data.Entity.dll

Menambahkan yang ditentukan ObjectParameter ke koleksi.

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

parameter

ObjectParameter

Parameter yang akan ditambahkan ke koleksi.

Penerapan

Add(T)

Pengecualian

ArgumentNullException

Argumennya parameter adalah null.

ArgumentException

Argumen parameter sudah ada dalam koleksi. Perilaku ini berbeda dari sebagian besar koleksi yang memungkinkan entri duplikat.

-atau-

Parameter lain dengan nama parameter yang sama dengan argumen sudah ada dalam koleksi. Perhatikan bahwa pencarian tidak peka huruf besar/kecil. Perilaku ini berbeda dari sebagian besar koleksi, dan lebih seperti itu dari Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Tipe tidak parameter valid.

Contoh

Contoh ini menambahkan parameter baru ke koleksi. Ini berulang melalui ObjectParameterCollection dan menampilkan nama, jenis, dan nilai setiap parameter dalam koleksi.

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

Keterangan

Setelah parameter ditambahkan, parameter dapat dihapus dari koleksi dan koleksi dapat dibersihkan, selama kueri belum dikompilasi atau dijalankan. Nama parameter tidak dapat diubah, tetapi nilai dapat diubah kapan saja.

Parameter harus unik di ObjectParameterCollection. Tidak boleh ada dua parameter dalam koleksi dengan nama yang sama. Untuk informasi selengkapnya, lihat Metode Pembangun Kueri.

Lihat juga

• Mengkueri Data sebagai Objek dan Membentuk Hasil (Kerangka Kerja Entitas)