ObjectContext.AddObject(String, Object) Metode

Referensi

Definisi

Ruang nama:: System.Data.Objects

Rakitan:: System.Data.Entity.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan objek ke konteks objek.

public:
 void AddObject(System::String ^ entitySetName, System::Object ^ entity);

public void AddObject (string entitySetName, object entity);

member this.AddObject : string * obj -> unit

Public Sub AddObject (entitySetName As String, entity As Object)

Parameter

entitySetName: String

Mewakili nama kumpulan entitas, yang mungkin secara opsional memenuhi syarat oleh nama kontainer entitas.

entity: Object

yang Object akan ditambahkan.

Pengecualian

ArgumentNullException

Parameternya entity adalah null.

-atau-

entitySetName tidak memenuhi syarat.

Contoh

Contoh ini menambahkan produk baru dan menyimpan perubahan ke database.

Product newProduct;

// Define values for the new product.
string dateTimeString = "1998-06-01 00:00:00.000";
string productName = "Flat Washer 10";
string productNumber = "FW-5600";
Int16 safetyStockLevel = 1000;
Int16 reorderPoint = 750;

// Convert the date time string into a DateTime instance.
DateTime sellStartDate;
if (!DateTime.TryParse(dateTimeString, out sellStartDate))
{
    throw new ArgumentException(string.Format("The string '{0}'cannot "
        + "be converted to DateTime.", dateTimeString));
}

// Create a new Product.
newProduct = Product.CreateProduct(0,
    productName, productNumber, false, false, safetyStockLevel, reorderPoint,
    0, 0, 0, DateTime.Today, Guid.NewGuid(), DateTime.Today);

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    try
    {
        // Add the new object to the context.
        context.Products.AddObject(newProduct);

        // Persist the new produc to the data source.
        context.SaveChanges();

        // Return the identity of the new product.
        return newProduct.ProductID;
    }
    catch (UpdateException ex)
    {
        throw new InvalidOperationException(string.Format(
            "The object could not be added. Make sure that a "
            + "product with a product number '{0}' does not aleady exist.\n",
            newProduct.ProductNumber), ex);
    }
}

Keterangan

ObjectContext Panggil AddObject untuk menambahkan objek ke konteks objek. Lakukan ini ketika objek adalah objek baru yang belum ada di sumber data. Untuk informasi selengkapnya, lihat Melampirkan dan Melepaskan Objek.

Objek ditambahkan ke ObjectStateManager dalam Detachedstatus , Deleted atau Added .

Saat Anda membuat objek baru yang terkait dengan objek lain dalam konteks objek, tambahkan objek dengan menggunakan salah satu metode berikut:

Add Panggil metode pada EntityCollection<TEntity> dan tentukan objek terkait. Lakukan ini untuk hubungan satu-ke-banyak atau banyak-ke-banyak.
Atur Value properti ke EntityReference<TEntity> objek terkait. Lakukan ini untuk hubungan satu-ke-satu atau banyak-ke-satu.

Untuk informasi selengkapnya, lihat Membuat, Menambahkan, Memodifikasi, dan Menghapus Objek.

Jika objek dalam keadaan terlepas, objek tidak boleh memiliki EntityKey.

Aturan untuk entitySetName format adalah sebagai berikut:

DefaultContainerName Jika properti adalah null, maka entitySetName harus sepenuhnya memenuhi syarat seperti dalam <Nama> Kontainer Entitas.<Nama> Set Entitas.
Jika DefaultContainerName tidak null, maka entitySetName dapat berupa <Nama> Kontainer Entitas.<Nama> Set Entitas atau <Nama> Set Entitas.

object Jika memiliki EntityKey dan entitySetName memiliki nilai, kunci EntitySet entitas harus cocok dengan EntitySet yang ditemukan berdasarkan entitySetName nama kontainer entitas dan .

Berlaku untuk

Share via