DataServiceContext.AttachTo Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
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. |
| 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. |
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.
public:
void AttachTo(System::String ^ entitySetName, System::Object ^ entity);public void AttachTo (string entitySetName, object entity);member this.AttachTo : string * obj -> unitPublic Sub AttachTo (entitySetName As String, entity As Object)Parámetros
- entitySetName
- String
Nombre del conjunto que contiene el recurso.
- entity
- Object
Recurso del que DataServiceContext va a realizar un seguimiento. El recurso se adjunta en el estado Unchanged.
Excepciones
entity o entitySetName es null.
entitySetName es una cadena vacía.
O bien
entity no tiene definida una propiedad de clave.
entity ya se está realizando un seguimiento por el contexto.
Comentarios
Si la entidad forma parte de un gráfico de objetos, esta operación no atraviesa el gráfico para agregar objetos relacionados. Se trata de una operación superficial.
El método no valida si el conjunto de entidades especificado se produce en el servicio de datos asociado a DataServiceContext.
Se aplica a
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.
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 -> unitPublic 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á adjunta la entidad.
- entity
- Object
Entidad que se va a agregar.
- etag
- String
Valor etag que representa el estado de la entidad la última vez que se recuperó del servicio de datos. Este valor se trata como una cadena opaca; la biblioteca cliente no realiza ninguna validación en él.
Excepciones
entitySetName es una cadena vacía.
O bien
El objeto proporcionado no tiene una propiedad de clave.
El contexto ya está realizando el seguimiento del objeto proporcionado.
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.
Si la entidad forma parte de un gráfico de objetos, esta operación no atraviesa el gráfico para agregar objetos relacionados. El objeto se agrega a DataServiceContext en el estado sin modificar. El método no valida si el conjunto de entidades especificado se produce en el servicio de datos asociado a DataServiceContext.
Si se usa la sobrecarga con un valor etag, el etag especificado se asocia a la entidad recién adjuntada. 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. 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.
