创建实体 c# d365 - C#

在 Dynamics 365 中创建实体可以帮助我们管理业务数据。本文将介绍如何使用 C# 在 Dynamics 365 中创建实体。

步骤 1: 引用 Microsoft.Xrm.Sdk.dll

在创建实体之前，需要添加对 Microsoft.Xrm.Sdk.dll 的引用。打开项目，在解决方案资源管理器中右键单击“引用”，然后选择“添加引用”。

在“添加引用”窗口中，转到“浏览”选项卡，并选择 Microsoft.Xrm.Sdk.dll。点击“确定”完成引用添加。

步骤 2: 创建实体类

在项目中创建一个类，命名为实体名称。在类中，使用以下代码片段创建实体类。

using Microsoft.Xrm.Sdk;

namespace [实体命名空间]
{
    [EntityLogicalName("[实体逻辑名称]")]
    public class [实体类名] : Entity
    {
        public [实体类名]() : base("[实体逻辑名称]")
        {

        }

        [AttributeLogicalName("[实体字段名称]")]
        public string [实体字段名称] 
        {
            get { return GetAttributeValue<string>("[实体字段名称]"); }
            set { SetAttributeValue("[实体字段名称]", value); }
        }
    }
}

在代码中替换以下内容：

• [实体命名空间]：实体类所在命名空间的名称。
• [实体逻辑名称]：实体的逻辑名称。
• [实体类名]：实体类的名称。
• [实体字段名称]：实体中的字段名称。

步骤 3: 设置实体元数据

在我们创建实体之后，需要设置实体元数据。如下是设置实体元数据的代码。

using Microsoft.Xrm.Sdk.Messages;
using Microsoft.Xrm.Sdk.Metadata;
using Microsoft.Xrm.Sdk.Query;

public static void CreateEntity(IOrganizationService service)
{
    CreateEntityRequest createEntityRequest = new CreateEntityRequest
    {
        Entity = new EntityMetadata
        {
            LogicalName = [实体逻辑名称],
            DisplayName = new Label([实体名称], 1033),
            DisplayCollectionName = new Label([实体名称], 1033),
            PrimaryAttribute = new StringAttributeMetadata
            {
                SchemaName = [主属性名称],
                RequiredLevel = new AttributeRequiredLevelManagedProperty(AttributeRequiredLevel.ApplicationRequired),
                MaxLength = 100,
                DisplayName = new Label([主属性名称], 1033),
                Description = new Label([主属性描述], 1033)
            }
        },
        Navigation = new RelationshipMetadataBase[0]
    };
    service.Execute(createEntityRequest);
}

在代码中替换以下内容：

• [实体逻辑名称]：实体的逻辑名称。
• [实体名称]：实体的名称。
• [主属性名称]：主属性的名称。
• [主属性描述]：主属性的描述。

步骤 4: 创建实体数据

创建实体完成后，我们可以使用以下代码创建实体数据。

public static void CreateRecord(IOrganizationService service)
{
    Entity entity = new [实体类名]();
    entity.[实体字段名称] = [实体值];
    service.Create(entity);
}

在代码中替换以下内容：

• [实体类名]：实体类的名称。
• [实体字段名称]：实体中的字段名称。
• [实体值]：实体字段的值。

完成上述步骤后，我们就可以在 Dynamics 365 中使用 C# 创建实体了。

参考文献: Microsoft Docs