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 DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.
Überlädt
AttachTo(String, Object) |
Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an. |
AttachTo(String, Object, String) |
Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an. |
AttachTo(String, Object)
Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.
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)
Parameter
- entitySetName
- String
Der Name des Satzes, der den Fehler enthält.
- entity
- Object
Die Ressource, die von DataServiceContext nachverfolgt werden soll. Die Ressource wird mit dem Status Unverändert angefügt.
Ausnahmen
entity
oder entitySetName
ist null
.
entitySetName
ist eine leere Zeichenfolge.
- oder -
entity
ist 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 verknüpfte Objekte hinzuzufügen. Es ist ein flacher Vorgang.
Die Methode überprüft nicht, ob die angegebene Entitätenmenge im Datendienst zu DataServiceContext auftritt.
Gilt für:
AttachTo(String, Object, String)
Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.
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)
Parameter
- entitySetName
- String
Eine Zeichenfolge, die den Namen der Entität enthält, an der die Entität angehängt ist.
- entity
- Object
Die Entität, die hinzugefügt werden soll.
- etag
- String
Ein eTag-Wert, der den Status der Entität beim letzten Abrufen aus dem Datendienst darstellt. Dieser Wert wird als nicht transparente Zeichenfolge behandelt; keine Validierung durch die Clientbibliothek.
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
Beim Aufruf dieser Methode wird DataServiceContext aufgefordert, mit dem Verfolgen der angegebenen Entität zu beginnen. Die Entität, zu der diese Entität gehört, wird identifiziert.
Wenn die Entität Teil eines Objektdiagramms ist, durchläuft dieser Vorgang das Diagramm nicht, um verknüpfte Objekte hinzuzufügen. Das Objekt wird unverändert zu DataServiceContext hinzugefügt. Die Methode überprüft nicht, ob die angegebene Entitätenmenge im Datendienst zu DataServiceContext auftritt.
Wenn die Überladung mit einem eTag verwendet wird, ist das angegebene eTag der neu angefügten Entität zugeordnet. Das eTag wird dann an den Datendienst gesendet (mit allen nachfolgenden Updates oder Abfragen für die Entität, nach HTTP-Semantik). Manuelle Generierung von eTag-Werten wird nicht empfohlen, aber diese Überladung wird bereitgestellt, um Entitäten zu aktivieren, die möglicherweise serialisiert und gespeichert wurden, um erneut zusammen mit relevanten Parallelitätsmetadaten angehängt zu werden.