DataServiceContext.AddLink(Object, String, Object) Metoda

Definicja

Przestrzeń nazw:

System.Data.Services.Client

Zestaw:

System.Data.Services.Client.dll

Dodaje określony link do zestawu obiektów, które DataServiceContext śledzi.

public:
 void AddLink(System::Object ^ source, System::String ^ sourceProperty, System::Object ^ target);

public void AddLink (object source, string sourceProperty, object target);

member this.AddLink : obj * string * obj -> unit

Public Sub AddLink (source As Object, sourceProperty As String, target As Object)

Parametry

source

Object

Obiekt źródłowy dla nowego linku.

sourceProperty

String

Nazwa właściwości nawigacji obiektu źródłowego zwracającego powiązany obiekt.

target

Object

Obiekt powiązany z obiektem źródłowym za pomocą nowego linku.

Wyjątki

ArgumentNullException

W przypadku sourcewartości , sourcePropertylub target mają wartość null.

InvalidOperationException

Jeśli łącze już istnieje.

-lub-

Jeśli obiekty source lub są w Detached stanie lub Deletedtarget.

-lub-

Jeśli sourceProperty nie jest kolekcją.

Przykłady

W poniższym przykładzie pokazano, jak używać AddLink metod i SetLink do tworzenia linków definiujących relacje. W tym przykładzie Order_Details właściwości nawigacji w obiekcie są również jawnie ustawione. W tym przykładzie użyto DataServiceContext narzędzia Add Service Reference opartego na usłudze danych Northwind, która jest tworzona po zakończeniu Usługi danych programu WCF .

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)

Uwagi

Powiadamia o DataServiceContext tym, że istnieje nowy link między powiązanymi obiektami źródłowymi i docelowymi oraz że łącze jest reprezentowane przez określoną właściwość źródłową. Ten DataServiceContext link dodaje do zestawu nowo utworzonych linków, które zostaną wysłane do usługi danych w następnym wywołaniu do SaveChanges.

Łącza to relacje jednokierunkowe. Ponieważ skojarzenia są dwukierunkowe, w skojarzeniu jeden-do-jednego należy wywołać albo AddLink ponownie, aby utworzyć link odwrotny, a w skojarzeniu wiele-do-jednego należy wywołać SetLink , aby utworzyć link odwołania do "jednego" końca skojarzenia.

Obiekt docelowy musi być typu identyfikowanego przez sourceProperty parametr lub podtyp typu.