DataServiceContext.AttachTo Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Benachrichtigt den Anfang der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource im angegebenen Ressourcensatz bereit.
Überlädt
| Name | Beschreibung |
|---|---|
| AttachTo(String, Object) |
Benachrichtigt den Beginn der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource innerhalb des angegebenen Ressourcensatzes bereit. |
| AttachTo(String, Object, String) |
Benachrichtigt den Anfang der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource im angegebenen Ressourcensatz bereit. |
AttachTo(String, Object)
Benachrichtigt den Beginn der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource innerhalb des angegebenen Ressourcensatzes bereit.
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)Parameter
- entitySetName
- String
Der Name des Satzes, der die Ressource enthält.
- entity
- Object
Die Ressource, die von der DataServiceContext. Die Ressource wird im Zustand "Unverändert" angefügt.
Ausnahmen
entity oder entitySetName ist null.
entitySetName ist eine leere Zeichenfolge.
-oder-
entity hat keine Schlüsseleigenschaft definiert.
entity wird bereits vom Kontext nachverfolgt.
Hinweise
Wenn die Entität Teil eines Objektdiagramms ist, durchläuft dieser Vorgang das Diagramm nicht, um verwandte Objekte hinzuzufügen. Es handelt sich um einen flachen Vorgang.
Die Methode überprüft nicht, ob der angegebene Entitätssatz im mit dem DataServiceContextDatendienst verknüpften Datendienst auftritt.
Gilt für:
AttachTo(String, Object, String)
Benachrichtigt den Anfang der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource im angegebenen Ressourcensatz bereit.
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)Parameter
- entitySetName
- String
Der Zeichenfolgenwert, der den Namen der Entität enthält, der an die Entität angefügt ist.
- entity
- Object
Die hinzuzufügende Entität.
- etag
- String
Ein etag-Wert, der den Status der Entität darstellt, wenn sie das letzte Mal vom Datendienst abgerufen wurde. Dieser Wert wird als undurchsichtige Zeichenfolge behandelt. Es wird keine Überprüfung durch die Clientbibliothek ausgeführt.
Ausnahmen
entitySetName ist eine leere Zeichenfolge.
-oder-
Das angegebene Objekt verfügt nicht über eine Schlüsseleigenschaft.
Das angegebene Objekt wird bereits vom Kontext nachverfolgt.
Hinweise
Durch Aufrufen dieser Methode wird die DataServiceContext Nachverfolgung der angegebenen Entität benachrichtigt und der Entitätssatz identifiziert, zu dem die Entität gehört.
Wenn die Entität Teil eines Objektdiagramms ist, durchläuft dieser Vorgang das Diagramm nicht, um verwandte Objekte hinzuzufügen. Das Objekt wird dem DataServiceContext unveränderten Zustand hinzugefügt. Die Methode überprüft nicht, ob der angegebene Entitätssatz im mit dem DataServiceContextDatendienst verknüpften Datendienst auftritt.
Wenn die Überladung mit einem eTag verwendet wird, wird das angegebene etag der neu angefügten Entität zugeordnet. Das Etag wird dann an den Datendienst gesendet, wobei alle nachfolgenden Aktualisierungs- oder Abfragevorgänge für die Entität entsprechend der HTTP-Semantik ausgeführt werden. Die manuelle Generierung von etag-Werten wird nicht empfohlen, aber diese Überladung wird bereitgestellt, um Entitäten zu ermöglichen, die möglicherweise serialisiert und gespeichert wurden, zusammen mit relevanten Parallelitätsmetadaten neu angefügt zu werden.
