DataServiceContext.AddLink(Object, String, Object) メソッド

定義

名前空間:

System.Data.Services.Client

アセンブリ:

System.Data.Services.Client.dll

DataServiceContext が追跡しているオブジェクトのセットに、指定されたリンクを追加します。

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)

パラメーター

source

Object

新しいリンクのソース オブジェクト。

sourceProperty

String

関連オブジェクトを返すソース オブジェクトのナビゲーション プロパティの名前。

target

Object

新しいリンクによってソース オブジェクトに関連付けられたオブジェクト。

例外

ArgumentNullException

source、sourceProperty、または target が null の場合。

InvalidOperationException

リンクが既に存在する場合。

- または -

source または target オブジェクトの状態が Detached または Deleted の場合。

- または -

sourceProperty がコレクションではない場合。

例

次の例では、AddLink メソッドおよび SetLink メソッドを使用して、リレーションシップを定義するリンクを作成する方法を示します。 この例では、Order_Details オブジェクトのナビゲーション プロパティも明示的に設定されます。 この例では、DataServiceContextNorthwind データ サービスに基づいてサービス参照の追加ツールによって生成された を使用します。これは、WCF Data Servicesが完了したときに作成されます。

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)

注釈

関連するソース オブジェクトとターゲット オブジェクトの間に新しいリンクが存在することと、そのリンクが指定したソース プロパティで表されることを DataServiceContext に通知します。 DataServiceContext は、次に SaveChanges を呼び出したときにデータ サービスに送信される新しく作成されたリンクのセットにこのリンクを追加します。

リンクは一方向のリレーションシップです。 関連付けは双方向であるため、一対一の関連付けでは、逆リンクを作成するためにもう一度を AddLink 呼び出す必要があります。多対一の関連付けでは、 を呼び出 SetLink して、関連付けの "一" 終了への参照リンクを作成する必要があります。

ターゲット オブジェクトは、sourceProperty パラメーターで識別される型かその型のサブタイプである必要があります。