DataServiceContext.AttachTo Método

Definición

Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso en el conjunto de recursos especificado.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource in the specified resource set.

Sobrecargas

AttachTo(String, Object)

Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso dentro del conjunto de recursos especificado.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource within the specified resource set.

AttachTo(String, Object, String)

Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso en el conjunto de recursos especificado.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource in the specified resource set.

AttachTo(String, Object)

Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso dentro del conjunto de recursos especificado.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource within the specified resource set.

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)

Parámetros

entitySetName
String

Nombre del conjunto que contiene el recurso.The name of the set that contains the resource.

entity
Object

Recurso del que DataServiceContext va a realizar un seguimiento.The resource to be tracked by the DataServiceContext. El recurso se asocia en el estado Sin cambios.The resource is attached in the Unchanged state.

Excepciones

Cuando entity o entitySetName es null.When entity or entitySetName is null.

Cuando entitySetName es una cadena vacía.When entitySetName is an empty string.

O bien-or- Cuando entity no tiene definida una propiedad clave.When the entity does not have a key property defined.

Cuando el contexto ya está realizando un seguimiento de entity.When the entity is already being tracked by the context.

Comentarios

Si la entidad forma parte de un gráfico de objetos, esta operación no atraviesa el gráfico para agregar objetos relacionados.If the entity is part of an object graph, this operation does not traverse the graph to add related objects. Se trata de una operación superficial.It is a shallow operation.

El método no valida si el conjunto de entidades especificado se produce en el servicio de datos asociado a DataServiceContext.The method does not validate whether the specified entity set occurs in the data service associated with the DataServiceContext.

AttachTo(String, Object, String)

Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso en el conjunto de recursos especificado.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource in the specified resource set.

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)

Parámetros

entitySetName
String

Valor de cadena que contiene el nombre del conjunto de entidades al que está asociado la entidad.The string value that contains the name of the entity set to which to the entity is attached.

entity
Object

Entidad que se va a agregar.The entity to add.

etag
String

Valor etag que representa el estado de la entidad la última vez que se recuperó del servicio de datos.An etag value that represents the state of the entity the last time it was retrieved from the data service. Este valor se considera como una cadena opaca; la biblioteca de cliente no realiza ninguna validación en él.This value is treated as an opaque string; no validation is performed on it by the client library.

Excepciones

Cuando entitySetName es null.When entitySetName is null.

O bien-or- Cuando entity es null.When entity is null.

Cuando entitySetName es una cadena vacía.When entitySetName is an empty string.

o bien-or- Cuando el objeto proporcionado no tiene una propiedad de clave.When the supplied object does not have a key property.

Cuando el contexto ya está realizando un seguimiento del objeto suministradoWhen the supplied object is already being tracked by the context

Comentarios

Al llamar a este método se notifica a DataServiceContext que empiece a realizar un seguimiento de la entidad especificada e identifique el conjunto de entidades al que pertenece la entidad.Calling this method notifies the DataServiceContext to start tracking the specified entity and identifies the entity set to which the entity belongs.

Si la entidad forma parte de un gráfico de objetos, esta operación no atraviesa el gráfico para agregar objetos relacionados.If the entity is part of an object graph, this operation does not traverse the graph to add related objects. El objeto se agrega a DataServiceContext en el estado sin modificar.The object is added to the DataServiceContext in the unchanged state. El método no valida si el conjunto de entidades especificado se produce en el servicio de datos asociado a DataServiceContext.The method does not validate whether the entity set specified occurs in the data service associated with the DataServiceContext.

Si se usa la sobrecarga con un valor etag, el etag especificado se asocia a la entidad recién adjuntada.If the overload with an etag is used, the specified etag is associated with the newly attached entity. A continuación, el valor etag se envía al servicio de datos, con todas las operaciones de actualización o consulta subsiguientes para la entidad, según la semántica de HTTP.The etag is then sent to the data service, with all subsequent update or query operations for the entity, according to HTTP semantics. No se recomienda la generación manual de valores etag, pero esta sobrecarga se proporciona para permitir volver a adjuntar entidades que se pueden haber serializado y almacenado junto con los metadatos de simultaneidad pertinentes.Manual generation of etag values is not recommended, but this overload is provided to enable entities that may have been serialized and stored to be reattached together with relevant concurrency metadata.

Se aplica a