Freigeben über


DataServiceContext.AttachTo-Methode (String, Object, String)

Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)

Syntax

'Declaration
Public Sub AttachTo ( _
    entitySetName As String, _
    entity As Object, _
    etag As String _
)
'Usage
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
)

Parameter

  • entitySetName
    Typ: System.String
    Eine Zeichenfolge, die den Namen der Entität enthält, an der die Entität angehängt ist.
  • entity
    Typ: System.Object
    Die Entität, die hinzugefügt werden soll.
  • etag
    Typ: System.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 von der Clientbibliothek.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Wenn entitySetName nullein NULL-Verweis (Nothing in Visual Basic) ist.

- oder -

Wenn entity nullein NULL-Verweis (Nothing in Visual Basic) ist.

ArgumentException

Wenn entitySetName eine leere Zeichenfolge ist.

- oder -

Wenn das angegebene Objekt nicht über eine Schlüsseleigenschaft verfügt.

InvalidOperationException

Wenn das angegebene Objekt bereits vom Kontext nachverfolgt wird

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 Aktualisierungen 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.

Siehe auch

Verweis

DataServiceContext Klasse

AttachTo-Überladung

System.Data.Services.Client-Namespace