DataServiceContext.AttachTo Método (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.
Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Sintaxis
'Declaración
Public Sub AttachTo ( _
entitySetName As String, _
entity As Object, _
etag As String _
)
'Uso
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
Dim etag As String
instance.AttachTo(entitySetName, entity, _
etag)
public void AttachTo(
string entitySetName,
Object entity,
string etag
)
public:
void AttachTo(
String^ entitySetName,
Object^ entity,
String^ etag
)
member AttachTo :
entitySetName:string *
entity:Object *
etag:string -> unit
public function AttachTo(
entitySetName : String,
entity : Object,
etag : String
)
Parámetros
- entitySetName
Tipo: System.String
Valor de cadena que contiene el nombre del conjunto de entidades al que está adjunta la entidad.
- entity
Tipo: System.Object
Entidad que se va a agregar.
- etag
Tipo: System.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
| Excepción | Condición |
|---|---|
| ArgumentNullException | Cuando entitySetName es nulles una referencia NULL (Nothing en Visual Basic).. O bien Cuando entity es nulles una referencia NULL (Nothing en Visual Basic).. |
| ArgumentException | Cuando entitySetName es una cadena vacía. O bien Cuando el objeto proporcionado no tiene una propiedad clave. |
| InvalidOperationException | Cuando el contexto ya está realizando un 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.