Метод DataServiceContext.AddObject
Добавляет указанный объект к набору отслеживаемых объектов DataServiceContext.
Пространство имен: System.Data.Services.Client
Сборка: Microsoft.Data.Services.Client (в Microsoft.Data.Services.Client.dll)
Синтаксис
'Декларация
Public Sub AddObject ( _
entitySetName As String, _
entity As Object _
)
'Применение
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
instance.AddObject(entitySetName, entity)
public void AddObject(
string entitySetName,
Object entity
)
public:
void AddObject(
String^ entitySetName,
Object^ entity
)
member AddObject :
entitySetName:string *
entity:Object -> unit
public function AddObject(
entitySetName : String,
entity : Object
)
Параметры
- entitySetName
Тип: System.String
Имя набора сущностей, в который добавляется ресурс.
- entity
Тип: System.Object
Объект, который требуется отслеживать с помощью DataServiceContext.
Исключения
Исключение | Условие |
---|---|
ArgumentNullException | Если entitySetName или entity имеет значение NULL. |
ArgumentException | Если entitySetName пуст. или Если entity не имеет определенного ключевого свойства. |
InvalidOperationException | Если сущность уже отслеживается контекстом. |
Замечания
Объект помещается в отслеживаемый набор DataServiceContext в состоянии Added. DataServiceContext пытается вставить объект с помощью HTTP POST при следующем вызове SaveChanges. Этот метод не добавляет объекты, связанные с указанной сущностью, к DataServiceContext. Каждый объект должен добавляться посредством отдельного вызова AddObject.
Данный метод не проверяет, находится ли указанный набор сущностей в службе данных, связанной с DataServiceContext, или имеет ли добавленный объект свойства, необходимые для добавления к указанному набору сущностей.