DataServiceContext.AttachTo Método

  • Referencia

Definición

Espacio de nombres:
System.Data.Services.Client
Ensamblado:
System.Data.Services.Client.dll

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 -> unit
Public 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

ArgumentNullException

entity o entitySetName es null.

ArgumentException

entitySetName es una cadena vacía.

O bien

entity no tiene definida una propiedad de clave.

InvalidOperationException

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 -> 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á 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

ArgumentNullException

entitySetName es null.

O bien

entity es null.

ArgumentException

entitySetName es una cadena vacía.

O bien

El objeto proporcionado no tiene una propiedad de clave.

InvalidOperationException

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.

Se aplica a