Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.