DataServiceContext.SetLink(Object, String, Object) 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 DataServiceContext, dass ein neuer Link zwischen den Objekten vorhanden ist und dass der Link von der durch den sourceProperty
-Parameter angegebenen Eigenschaft dargestellt wird.
public:
void SetLink(System::Object ^ source, System::String ^ sourceProperty, System::Object ^ target);
public void SetLink (object source, string sourceProperty, object target);
member this.SetLink : obj * string * obj -> unit
Public Sub SetLink (source As Object, sourceProperty As String, target As Object)
Parameter
- source
- Object
Das Quellobjekt für den neuen Link.
- sourceProperty
- String
Die Eigenschaft des Quellobjekts, das das Zielobjekt des neuen Links identifiziert.
- target
- Object
Das untergeordnete Objekt des neuen Links, der durch das Aufrufen dieser Methode initialisiert werden soll. Das Zielobjekt muss ein Untertyp des Typs sein, der vom sourceProperty
-Parameter identifiziert wurde. Wenn target
auf NULL gesetzt wird, stellt der Aufruf einen Löschlinkvorgang dar.
Ausnahmen
Wenn source
, sourceProperty
oder target
NULL sind.
Der angegebene Link ist bereits vorhanden.
Oder
Die als source
oder target
angegebenen Objekte befinden sich Detached im Zustand oder Deleted .
Oder
sourceProperty
ist keine Navigationseigenschaft, die einen Verweis auf ein einzelnes verknüpftes Objekt definiert.
Beispiele
Im folgenden Beispiel wird gezeigt, wie die AddLink-Methode und die SetLink-Methode verwendet werden, um Links zu erstellen, die Beziehungen definieren. In diesem Beispiel werden die Navigationseigenschaften für das Order_Details
-Objekt auch explizit festgelegt.
int productId = 25;
string customerId = "ALFKI";
Order_Detail newItem = null;
// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);
try
{
// Get the specific product.
var selectedProduct = (from product in context.Products
where product.ProductID == productId
select product).Single();
// Get the specific customer.
var cust = (from customer in context.Customers.Expand("Orders")
where customer.CustomerID == customerId
select customer).Single();
// Get the first order.
Order order = cust.Orders.FirstOrDefault();
// Create a new order detail for the specific product.
newItem = Order_Detail.CreateOrder_Detail(
order.OrderID, selectedProduct.ProductID, 10, 5, 0);
// Add the new order detail to the context.
context.AddToOrder_Details(newItem);
// Add links for the one-to-many relationships.
context.AddLink(order, "Order_Details", newItem);
context.AddLink(selectedProduct, "Order_Details", newItem);
// Add the new order detail to the collection, and
// set the reference to the product.
order.Order_Details.Add(newItem);
newItem.Product = selectedProduct;
// Send the changes to the data service.
DataServiceResponse response = context.SaveChanges();
// Enumerate the returned responses.
foreach (ChangeOperationResponse change in response)
{
// Get the descriptor for the entity.
EntityDescriptor descriptor = change.Descriptor as EntityDescriptor;
if (descriptor != null)
{
if (descriptor.Entity.GetType() == typeof(Order_Detail))
{
Order_Detail addedItem = descriptor.Entity as Order_Detail;
if (addedItem != null)
{
Console.WriteLine("New {0} item added to order {1}.",
addedItem.Product.ProductName, addedItem.OrderID.ToString());
}
}
}
}
}
catch (DataServiceQueryException ex)
{
throw new ApplicationException(
"An error occurred when saving changes.", ex);
}
// Handle any errors that may occur during insert, such as
// a constraint violation.
catch (DataServiceRequestException ex)
{
throw new ApplicationException(
"An error occurred when saving changes.", ex);
}
Dim productId = 25
Dim customerId = "ALFKI"
Dim newItem As Order_Detail = Nothing
' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)
Try
' Get the specific product.
Dim selectedProduct = (From product In context.Products _
Where product.ProductID = productId _
Select product).Single()
' Get the specific customer.
Dim cust = (From customer In context.Customers.Expand("Orders") _
Where customer.CustomerID = customerId _
Select customer).Single()
' Get the first order.
Dim order = cust.Orders.FirstOrDefault()
' Create a new order detail for the specific product.
newItem = Order_Detail.CreateOrder_Detail( _
order.OrderID, selectedProduct.ProductID, 10, 5, 0)
' Add the new order detail to the context.
context.AddToOrder_Details(newItem)
' Add links for the one-to-many relationships.
context.AddLink(order, "Order_Details", newItem)
context.AddLink(selectedProduct, "Order_Details", newItem)
' Add the new order detail to the collection, and
' set the reference to the product.
order.Order_Details.Add(newItem)
newItem.Product = selectedProduct
' Send the insert to the data service.
Dim response As DataServiceResponse = context.SaveChanges()
' Enumerate the returned responses.
For Each change As ChangeOperationResponse In response
' Get the descriptor for the entity.
Dim descriptor = TryCast(change.Descriptor, EntityDescriptor)
If Not descriptor Is Nothing Then
Dim addedProduct = TryCast(descriptor.Entity, Product)
If Not addedProduct Is Nothing Then
Console.WriteLine("New product added with ID {0}.", _
addedProduct.ProductID)
End If
End If
Next
Catch ex As DataServiceQueryException
Throw New ApplicationException( _
"An error occurred when saving changes.", ex)
' Handle any errors that may occur during insert, such as
' a constraint violation.
Catch ex As DataServiceRequestException
Throw New ApplicationException( _
"An error occurred when saving changes.", ex)
Hinweise
Ein neuer Link wird mit dem Status Added erstellt. DataServiceContext fügt diesen neuen Link dem Satz von neu erstellten Links hinzu, der beim nächsten Aufruf von SaveChanges an den Datendienst gesendet werden.
Wenn das Zielargument NULL ist, sollte der von sourceProperty dargestellte Link entfernt werden (der Link wird in den Status Deleted versetzt).
Links sind unidirektionale Beziehungen. Wenn ein Rückzeiger vorhanden ist, der eine bidirektionale Zuordnung angibt, sollte diese Methode erneut aufgerufen werden, um den DataServiceContext des zweiten Links zu benachrichtigen.
Diese Methode unterstützt nur das Hinzufügen von Links zu Beziehungen mit Multiplizität = 1 (Die Quelleigenschaft ist ein Objektverweis). Wenn eine Klasse Person
mit einer anderen Person
durch die Eigenschaft Friend
verbunden ist, kann mit diesem Aufruf Person
mit Person
verbunden werden. Diese Methode löst eine Ausnahme aus, wenn der dargestellte Parameter sourceProperty
mehrere Kardinalitätsbeziehungen aufweist.