DataServiceContext.AttachTo Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt DataServiceContext aangegeven dat de opgegeven resource wordt bijgehouden en wordt de locatie van de resource in de opgegeven resourceset geleverd.
Overloads
| Name | Description |
|---|---|
| AttachTo(String, Object) |
Hiermee wordt aangegeven dat de DataServiceContext opgegeven resource wordt bijgehouden en wordt de locatie van de resource binnen de opgegeven resourceset geleverd. |
| AttachTo(String, Object, String) |
Hiermee wordt DataServiceContext aangegeven dat de opgegeven resource wordt bijgehouden en wordt de locatie van de resource in de opgegeven resourceset geleverd. |
AttachTo(String, Object)
Hiermee wordt aangegeven dat de DataServiceContext opgegeven resource wordt bijgehouden en wordt de locatie van de resource binnen de opgegeven resourceset geleverd.
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)Parameters
- entitySetName
- String
De naam van de set die de resource bevat.
- entity
- Object
De resource die moet worden bijgehouden door de DataServiceContext. De resource is gekoppeld met de status Ongewijzigd.
Uitzonderingen
entity of entitySetName is null.
entitySetName is een lege tekenreeks.
– of –
entity er is geen sleuteleigenschap gedefinieerd.
entity wordt al bijgehouden door de context.
Opmerkingen
Als de entiteit deel uitmaakt van een objectgrafiek, gaat deze bewerking niet door de grafiek om gerelateerde objecten toe te voegen. Het is een ondiepe operatie.
De methode valideert niet of de opgegeven entiteitsset plaatsvindt in de gegevensservice die is gekoppeld aan de DataServiceContext.
Van toepassing op
AttachTo(String, Object, String)
Hiermee wordt DataServiceContext aangegeven dat de opgegeven resource wordt bijgehouden en wordt de locatie van de resource in de opgegeven resourceset geleverd.
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)Parameters
- entitySetName
- String
De tekenreekswaarde die de naam bevat van de entiteit die aan de entiteit is gekoppeld.
- entity
- Object
De entiteit die moet worden toegevoegd.
- etag
- String
Een etag-waarde die de status van de entiteit aangeeft wanneer deze de laatste keer is opgehaald uit de gegevensservice. Deze waarde wordt behandeld als een ondoorzichtige tekenreeks; er wordt geen validatie op uitgevoerd door de clientbibliotheek.
Uitzonderingen
entitySetName is een lege tekenreeks.
– of –
Het opgegeven object heeft geen sleuteleigenschap.
Het opgegeven object wordt al bijgehouden door de context.
Opmerkingen
Als u deze methode aanroept, wordt de DataServiceContext opgegeven entiteit bijgehouden en wordt de entiteit geïdentificeerd waartoe de entiteit behoort.
Als de entiteit deel uitmaakt van een objectgrafiek, gaat deze bewerking niet door de grafiek om gerelateerde objecten toe te voegen. Het object wordt toegevoegd aan de DataServiceContext ongewijzigde status. De methode valideert niet of de opgegeven entiteitsset plaatsvindt in de gegevensservice die is gekoppeld aan de DataServiceContext.
Als de overbelasting met een etag wordt gebruikt, wordt de opgegeven etag gekoppeld aan de zojuist gekoppelde entiteit. De etag wordt vervolgens naar de gegevensservice verzonden, met alle volgende update- of querybewerkingen voor de entiteit, volgens http-semantiek. Handmatige generatie van etag-waarden wordt niet aanbevolen, maar deze overbelasting wordt geboden om entiteiten in staat te stellen die mogelijk zijn geserialiseerd en opgeslagen om opnieuw te worden gekoppeld samen met relevante gelijktijdigheidsmetagegevens.
