DataServiceContext.UpdateObject メソッド

DataServiceContext 内で指定されたオブジェクトの状態を Modified に変更します。

名前空間:  System.Data.Services.Client
アセンブリ:  Microsoft.Data.Services.Client (Microsoft.Data.Services.Client.dll)

構文

'宣言
Public Sub UpdateObject ( _
    entity As Object _
)
'使用
Dim instance As DataServiceContext
Dim entity As Object

instance.UpdateObject(entity)
public void UpdateObject(
    Object entity
)
public:
void UpdateObject(
    Object^ entity
)
member UpdateObject : 
        entity:Object -> unit 
public function UpdateObject(
    entity : Object
)

パラメーター

例外

例外 条件
ArgumentNullException

entity が nullNULL 参照 (Visual Basic では Nothing) の場合。

ArgumentException

entity の状態が Detached の場合。

使用例

次の例では、既存のオブジェクトを取得および変更してから、DataServiceContext で UpdateObject メソッドを呼び出してコンテキスト内の項目を更新済みとしてマークします。 SaveChanges が呼び出されると、HTTP MERGE メッセージがデータ サービスに送信されます。 この例では、Northwind データ サービスに基づいてサービス参照の追加ツールによって生成される DataServiceContext を使用します。これは、WCF Data Services クイック スタートの完了時に作成されます。

Dim customerId = "ALFKI"

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Get a customer to modify using the supplied ID.
Dim customerToChange = (From customer In context.Customers _
                        Where customer.CustomerID = customerId _
                        Select customer).Single()

' Change some property values.
customerToChange.CompanyName = "Alfreds Futterkiste"
customerToChange.ContactName = "Maria Anders"
customerToChange.ContactTitle = "Sales Representative"

Try
    ' Mark the customer as updated.
    context.UpdateObject(customerToChange)

    ' Send the update to the data service.
    context.SaveChanges()
Catch ex As DataServiceRequestException
    Throw New ApplicationException( _
            "An error occurred when saving changes.", ex)
End Try
string customerId = "ALFKI";

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Get a customer to modify using the supplied ID.
var customerToChange = (from customer in context.Customers
                        where customer.CustomerID == customerId
                        select customer).Single();

// Change some property values.
customerToChange.CompanyName = "Alfreds Futterkiste";
customerToChange.ContactName = "Maria Anders";
customerToChange.ContactTitle = "Sales Representative";

try
{
    // Mark the customer as updated.
    context.UpdateObject(customerToChange);

    // Send the update to the data service.
    context.SaveChanges();
}
catch (DataServiceRequestException  ex)
{
    throw new ApplicationException(
        "An error occurred when saving changes.", ex);
}

関連項目

参照

DataServiceContext クラス

System.Data.Services.Client 名前空間