DataServiceContext.AttachTo Methode

  • Referenz

Definition

Namespace:
System.Data.Services.Client
Assembly:
System.Data.Services.Client.dll

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

ArgumentNullException

entity oder entitySetName ist null.

ArgumentException

entitySetName ist eine leere Zeichenfolge.

- oder -

entity ist keine Schlüsseleigenschaft definiert.

InvalidOperationException

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

ArgumentNullException

entitySetName ist null.

- oder -

entity ist null.

ArgumentException

entitySetName ist eine leere Zeichenfolge.

- oder -

Das angegebene Objekt verfügt nicht über eine Schlüsseleigenschaft.

InvalidOperationException

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.

Gilt für: