DataServiceContext.AttachTo Method (String, Object)
Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource within the specified resource set.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Sub AttachTo ( _
entitySetName As String, _
entity As Object _
)
'Usage
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
instance.AttachTo(entitySetName, entity)
public void AttachTo(
string entitySetName,
Object entity
)
public:
void AttachTo(
String^ entitySetName,
Object^ entity
)
member AttachTo :
entitySetName:string *
entity:Object -> unit
public function AttachTo(
entitySetName : String,
entity : Object
)
Parameters
- entitySetName
Type: System.String
The name of the set that contains the resource.
- entity
Type: System.Object
The resource to be tracked by the DataServiceContext. The resource is attached in the Unchanged state.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | When entity or entitySetName is nulla null reference (Nothing in Visual Basic). |
| ArgumentException | When entitySetName is an empty string. -or- When the entity does not have a key property defined. |
| InvalidOperationException | When the entity is already being tracked by the context. |
Remarks
If the entity is part of an object graph, this operation does not traverse the graph to add related objects. It is a shallow operation.
The method does not validate whether the specified entity set occurs in the data service associated with the DataServiceContext.