CreateManyToManyRequest CreateManyToManyRequest CreateManyToManyRequest CreateManyToManyRequest Class

Definition

Contains the data that is needed to create a new Many-to-Many (N:N) entity relationship.

public ref class CreateManyToManyRequest sealed : Microsoft::Xrm::Sdk::OrganizationRequest
[System.Runtime.Serialization.DataContract(Namespace="http://schemas.microsoft.com/xrm/2011/Contracts")]
public sealed class CreateManyToManyRequest : Microsoft.Xrm.Sdk.OrganizationRequest
type CreateManyToManyRequest = class
    inherit OrganizationRequest
Public NotInheritable Class CreateManyToManyRequest
Inherits OrganizationRequest
Inheritance
CreateManyToManyRequestCreateManyToManyRequestCreateManyToManyRequestCreateManyToManyRequest
Attributes

Examples

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. This sample creates the entity relationship between the Account and Contact entities by using CreateManyToManyRequest.

// Create Many to Many Request
bool accountEligibleParticipate = EligibleCreateManyToManyRelationship("account");
bool campaignEligibleParticipate = EligibleCreateManyToManyRelationship("campaign");

if (accountEligibleParticipate && campaignEligibleParticipate) { CreateManyToManyRequest createManyToManyRelationshipRequest = new CreateManyToManyRequest { IntersectEntitySchemaName = "new_accounts_campaigns", ManyToManyRelationship = new ManyToManyRelationshipMetadata { SchemaName = "new_accounts_campaigns", Entity1LogicalName = "account", Entity1AssociatedMenuConfiguration = new AssociatedMenuConfiguration { Behavior = AssociatedMenuBehavior.UseLabel, Group = AssociatedMenuGroup.Details, Label = new Label("Account", 1033), Order = 10000 }, Entity2LogicalName = "campaign", Entity2AssociatedMenuConfiguration = new AssociatedMenuConfiguration { Behavior = AssociatedMenuBehavior.UseLabel, Group = AssociatedMenuGroup.Details, Label = new Label("Campaign", 1033), Order = 10000 } } };

CreateManyToManyResponse createManytoManyRelationshipResponse =(CreateManyToManyResponse)svc.Execute(createManyToManyRelationshipRequest); _manyToManyRelationshipId = createManytoManyRelationshipResponse.ManyToManyRelationshipId; _manyToManyRelationshipName = createManyToManyRelationshipRequest.ManyToManyRelationship.SchemaName;

Console.WriteLine("The many-to-many relationship has been created between {0} and {1}.","account", "campaign"); }

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. For the complete sample, see the link later in this topic. . This sample creates the entity relationship between the Account and Contact entities by using CreateManyToManyRequest.

Relationships#WorkWithRelationships2 RelationshipsVB#WorkWithRelationships2

Remarks

Message Availability

For this message to work, the caller must be connected to the server.

Usage

Pass an instance of this class to the Execute(OrganizationRequest) method, which returns an instance of CreateManyToManyResponse.

Privileges and Access Rights

To perform this action, the caller must have privileges listed in CreateManyToMany message privileges.

Notes for Callers

Constructors

CreateManyToManyRequest() CreateManyToManyRequest() CreateManyToManyRequest() CreateManyToManyRequest()

Initializes a new instance of the CreateManyToManyRequest class.

Properties

ExtensionData ExtensionData ExtensionData ExtensionData

Gets or sets the structure that contains extra data. Optional.

(Inherited from OrganizationRequest)
IntersectEntitySchemaName IntersectEntitySchemaName IntersectEntitySchemaName IntersectEntitySchemaName

Gets or sets the name of the intersect entity to be created for this entity relationship. Required.

Item[String] Item[String] Item[String] Item[String]

Gets or sets the indexer for the Parameters collection.

(Inherited from OrganizationRequest)
ManyToManyRelationship ManyToManyRelationship ManyToManyRelationship ManyToManyRelationship

Gets or sets the definition of the Many-to-Many entity relationship to be created. Required.

Parameters Parameters Parameters Parameters

Gets or sets the collection of parameters for the request. Required, but is supplied by derived classes.

(Inherited from OrganizationRequest)
RequestId RequestId RequestId RequestId

Gets or sets the ID of an asynchronous operation (system job). Optional.

(Inherited from OrganizationRequest)
RequestName RequestName RequestName RequestName

Gets or sets the name of the request. Required, but is supplied by derived classes.

(Inherited from OrganizationRequest)
SolutionUniqueName SolutionUniqueName SolutionUniqueName SolutionUniqueName

Gets or sets the name of the unmanaged solution you want to add this many-to-many entity relationship to. Optional.

Applies to

See also