DataServiceContext.AttachTo Метод

Определение

Пространство имен:

System.Data.Services.Client

Сборка:

System.Data.Services.Client.dll

Уведомляет DataServiceContext о начале отслеживания указанного ресурса и предоставляет расположение ресурса в указанном наборе ресурсов.

Перегрузки

AttachTo(String, Object)	Уведомляет DataServiceContext о начале отслеживания указанного ресурса и предоставляет расположение ресурса в рамках указанного набора ресурсов.
AttachTo(String, Object, String)	Уведомляет DataServiceContext о начале отслеживания указанного ресурса и предоставляет расположение ресурса в указанном наборе ресурсов.

AttachTo(String, Object)

Уведомляет DataServiceContext о начале отслеживания указанного ресурса и предоставляет расположение ресурса в рамках указанного набора ресурсов.

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

public void AttachTo (string entitySetName, object entity);

member this.AttachTo : string * obj -> unit

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

Параметры

entitySetName

String

Имя набора, содержащего ресурс.

entity

Object

Ресурс, который требуется отслеживать с помощью DataServiceContext. Этот ресурс присоединен в неизмененном состоянии.

Исключения

ArgumentNullException

Параметр entity или entitySetName имеет значение null.

ArgumentException

Параметр entitySetName равен пустой строке.

-или-

entity не имеет определенного свойства ключа.

InvalidOperationException

entity уже отслеживается контекстом.

Комментарии

Если сущность является частью графа объектов, эта операция не просматривает граф для добавления связанных объектов. Это неполная операция.

Метод не проверяет наличие указанного набора сущностей в службе данных, связанной с DataServiceContext.

AttachTo(String, Object, String)

Уведомляет DataServiceContext о начале отслеживания указанного ресурса и предоставляет расположение ресурса в указанном наборе ресурсов.

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

public void AttachTo (string entitySetName, object entity, string etag);

member this.AttachTo : string * obj * string -> unit

Public Sub AttachTo (entitySetName As String, entity As Object, etag As String)

Параметры

entitySetName

String

Строковое значение, содержащее имя набора сущностей, к которому присоединяется сущность.

entity

Object

Добавляемая сущность.

etag

String

Значение etag, представляющее состояние сущности при ее последнем извлечении из службы данных. Это значение интерпретируется как непрозрачная строка. Клиентская библиотека не выполняет проверку этого значения.

Исключения

ArgumentNullException

entitySetName имеет значение null.

-или-

entity имеет значение null.

ArgumentException

Параметр entitySetName равен пустой строке.

-или-

Предоставленный объект не имеет свойства key.

InvalidOperationException

Предоставленный объект уже отслеживается контекстом.

Комментарии

Вызов этого метода уведомляет DataServiceContext о начале отслеживания указанной сущности и определяет набор сущностей, к которому принадлежит отслеживаемая сущность.

Если сущность является частью графа объектов, эта операция не просматривает граф для добавления связанных объектов. Объект добавляется в DataServiceContext в неизмененном состоянии. Метод не проверяет наличие указанного набора сущностей в службе данных, связанной с DataServiceContext.

Если используется перегрузка с etag, указанный etag ассоциируется с вновь присоединенной сущностью. Etag затем передается в службу данных со всеми последующими операциями обновления или запроса для сущности в соответствии с семантикой HTTP. Создавать значения etag вручную не рекомендуется. Эта перегрузка предоставляется для того, чтобы сущности, которые можно сериализовать и сохранять, можно было повторно подключить вместе с соответствующими метаданными параллелизма.