DataServiceContext.SetLink(Object, String, Object) Méthode

Définition

Espace de noms:

Microsoft.OData.Client

Assembly:

Microsoft.OData.Client.dll

Paquet:

Microsoft.OData.Client v7.9.0

Informe le DataServiceContext qu'un nouveau lien existe entre les objets spécifiés et que ce lien est représenté par la propriété spécifiée par le paramètre sourceProperty.

public virtual void SetLink (object source, string sourceProperty, object target);

abstract member SetLink : obj * string * obj -> unit
override this.SetLink : obj * string * obj -> unit

Public Overridable Sub SetLink (source As Object, sourceProperty As String, target As Object)

Paramètres

source

Object

Objet source pour le nouveau lien.

sourceProperty

String

Propriété sur l'objet source qui identifie l'objet cible du nouveau lien.

target

Object

L'objet enfant est impliqué dans le nouveau lien qui doit être initialisé en appelant cette méthode. L'objet cible doit être un sous-type du type identifié par le paramètre sourceProperty. Si target a la valeur null, l'appel représente une opération de suppression de lien.

Exceptions

ArgumentNullException

Lorsque source, sourceProperty ou target est null.

InvalidOperationException

Lorsque le lien spécifié existe déjà.-ou-Quand les objets fournis comme source ou target sont dans l’état Detached ou Deleted .-Ou-When sourceProperty n’est pas une propriété de navigation qui définit une référence à un objet associé unique.

Remarques

Avertit le contexte qu’un lien modifié existe entre les source objets et target et que le lien est représenté via la source.sourceProperty qui est une référence. Le contexte ajoute ce lien au jeu de liens créés modifiés à envoyer au service de données lors de l’appel suivant à SaveChanges(). Les liens sont des relations unidirectionnelles. S’il existe un pointeur arrière (c’est-à-dire une association bidirectionnelle), cette méthode doit être appelée une deuxième fois pour notifier l’objet de contexte du deuxième lien.