Implement Custom Business Classes and Reference Properties 实现自定义业务类和引用属性(XPO)

In this lesson, you will learn how to implement business classes from scratch. For this purpose, the Department and Position business classes will be implemented. These classes will be used in the Contact class, implemented previously. You will also learn the basics of automatic user interface construction for referenced objects.

在本课中，您将学习如何从头开始实现业务类。为此，将实施"部"和"职位"业务课程。这些类将在以前实现的"联系人"类中使用。您还将学习引用对象的自动用户界面构造基础知识。

Note

Before proceeding, take a moment to review the Inherit from the Business Class Library Class (XPO) lesson.

注意
在继续之前，请花点时间复习从商务舱库类 （XPO） 课程继承。

• Add the following Department and Position persistent classes to the Contact.cs (Contact.vb) file.

• 将以下部门和职位持久性类添加到Contact.cs （Contact.vb） 文件中。

  [DefaultClassOptions]
  [System.ComponentModel.DefaultProperty(nameof(Title))]
  public class Department : BaseObject {
      public Department(Session session) : base(session) { }
      private string title;
      public string Title {
          get { return title; }
          set { SetPropertyValue(nameof(Title), ref title, value); }
      }
      private string office;
      public string Office {
          get { return office; }
          set { SetPropertyValue(nameof(Office), ref office, value); }
      }
  }
  [DefaultClassOptions]
  [System.ComponentModel.DefaultProperty(nameof(Title))]
  public class Position : BaseObject {
      public Position(Session session) : base(session) { }
      private string title;
      public string Title {
          get { return title; }
          set { SetPropertyValue(nameof(Title), ref title, value); }
      }
  }

  These new classes are persistent, as they are BaseObject class descendants.

          这些新类是持久性的，因为它们是 BaseObject 类后代。

Note

The DefaultProperty attribute is used in the code above. This attribute is used to specify the default property of the class. You can specify the most descriptive property of your class in the DefaultProperty attribute, and its values will be displayed in the following.

注意
DefaultProperty 属性用于上述代码。此属性用于指定类的默认属性。您可以在 DefaultProperty 属性中指定类最具描述性的属性，其值将显示在以下内容中。

• Detail form captions
• The leftmost column of a List View
• The Lookup List Views (These Views will be explained in the last step of this lesson.)

 

• 详细信息表单标题
• 列表视图的最左侧列
• 查找列表视图（这些视图将在本课的最后一步中介绍。

Refer to the Data Annotations in Data Model topic for additional information.

 有关详细信息，请参阅数据模型中的数据注释主题。

• Add the Department and Position properties to the Contact class. The following code demonstrates this.

• 将"部门和位置"属性添加到"联系人"类。以下代码演示了这一点。
   

[DefaultClassOptions]
public class Contact : Person {
    //...
    private Department department;
    public Department Department {
        get {return department;}
        set {SetPropertyValue(nameof(Department), ref department, value);}
    }
    private Position position;
    public Position Position {
        get {return position;}
        set {SetPropertyValue(nameof(Position), ref position, value);}
    }
    //...
}

The Contact class now exposes the Position and Department reference properties.

联系人类现在公开"位置"和"部门"引用属性。

Note

If you have CodeRush

注意

如果您有代码CodeRush

• installed, you can use Code Templates when implementing business classes. Using Code Templates decreases code creation time, because it helps avoid having to type the entire code manually and allows you to create regular code sections with only a few keystrokes. To learn about the built-in Code Templates for eXpress Persistent Objects, refer to the XPO and XAF Templates topic.

  在实现业务类时，可以使用代码模板。使用代码模板可缩短代码创建时间，因为它有助于避免手动键入整个代码，并允许您只需几个击键即可创建常规代码部分。要了解 eXpress 持久对象的内置代码模板，请参阅 XPO 和 XAF 模板主题。

• Run the WinForms or ASP.NET application. You will see how the user interface is automatically generated using the specified data structures. The navigation control will contain new Department and Position items, which will allow you to access Department and Position objects. Note that in the Contact Detail View, a lookup editor has been created for Department and Position. In this editor, a special type of View, Lookup List View, is used. Typically, this View has a single column corresponding to the class' default property. Using the lookup editor, you can select the required Department (Position) for the current Contact, and add new Department (Position) objects using the New button. In addition, you will also be able to edit existing Department (Position) objects by holding down SHIFT+CTRL and clicking the selected object.

• 运行 WinForms 或ASP.NET应用程序。您将看到如何使用指定的数据结构自动生成用户界面。导航控件将包含新的"部门和位置"项，这将允许您访问"部门和定位"对象。请注意，在"联系人详细信息"视图中，已为部门和职位创建了查找编辑器。在此编辑器中，使用特殊类型的视图"查找列表视图"。通常，此视图具有对应于类的默认属性的单个列。使用查找编辑器，可以为当前联系人选择所需的部门（位置），并使用"新建"按钮添加新的"部门（位置）"对象。此外，您还可以通过按住 SHIFT_CTRL 并单击所选对象来编辑现有部门（位置）对象。

  

You can see the code demonstrated in this lesson in the MySolution.Module | Business Objects | Contact.cs (Contact.vb) file of the Main Demo installed with XAF. The MainDemo application is installed in %PUBLIC%DocumentsDevExpress Demos 19.2ComponentseXpressApp FrameworkMainDemo by default. The ASP.NET version is available online at http://demos.devexpress.com/XAF/MainDemo/

您可以在 MySolution.模块中看到本课中演示的代码。业务对象 |Contact.cs （Contact.vb） 文件的主演示安装与 XAF.默认情况下，主演示应用程序安装在 %PUBLIC%DocumentsDevExpress Demos 19.2ComponentseXpressApp FrameworkMainDemo中。ASP.NET版本可在 http://demos.devexpress.com/XAF/MainDemo/ 在线获取

.