Appointment.ResourceId Property

Gets or sets the unique identifier of the resource associated with the current appointment, or the ID of the first resource if resource sharing is enabled.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v18.2.Core.dll

Declaration

C#

object ResourceId { get; set; }

VB.NET

Property ResourceId As Object

Property Value

Type	Description
Object	A Object value that specifies the resource’s unique identifier.

Remarks

The ResourceId property specifies the identifier of the appointment’s associated resource. All resources must have unique IDs.

Tip

Use the Appointment.ResourceIds property to get a collection of associated resources if resource sharing is enabled.

Resources are used to group schedules. An appointment can be associated with a resource, or it can be standalone. To associate an appointment with a resource, the appointment’s ResourceId property should be set to the value specified by the required resource’s IPersistentObject.Id property. For standalone appointments, the ResourceId property is set to the EmptyResourceId value.

Note

If resource sharing is enabled (the AppointmentStorageBase.ResourceSharing property is set to true), the ResourceId property returns the ID of the first resource contained in the Appointment.ResourceIds collection.

Note

If an appointment doesn’t belong to any particular resource (the ResourceId property is set to the EmptyResourceId), the scheduler shows it for all resources when the SchedulerControl.GroupType property is set to the SchedulerGroupType.Resource or SchedulerGroupType.Date value. . Appointments without assigned resources are hidden if the SchedulerOptionsViewBase.ShowOnlyResourceAppointments property is set to true.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ResourceId property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-separate-shift-conflicted-appointments-while-dragging-another-appointment-e5007/CS/WindowsFormsApplication1/Form1.cs#L150

    TimeInterval dragAppointmentInterval = new TimeInterval(e.SourceAppointment.Start, e.SourceAppointment.End);
    ReOrderOtherAppointments(e.SourceAppointment.ResourceId, dragAppointmentInterval, e.SourceAppointment);
}));

winforms-schedulercontrol-api-t224044/CS/SchedulerAPISample/CodeExamples/AppointmentConflicts.cs#L22

Appointment apt1 = scheduler.DataStorage.Appointments.CreateAppointment(AppointmentType.Normal, DateTime.Now, DateTime.Now.AddHours(2));
apt1.ResourceId = scheduler.DataStorage.Resources[0].Id;
scheduler.DataStorage.Appointments.Add(apt1);

how-to-build-a-layout-similar-to-ms-outlook-calendar-in-overlay-mode-with-schedulercontrol-t191172/CS/SchedulerOverlay/Form1.cs#L67

string appointmentResourceName = String.Empty;
if (!(info.Appointment.ResourceId is EmptyResourceId))
    appointmentResourceName = schedulerStorage.Resources[(int)info.Appointment.ResourceId].Caption;

wpf-schedulercontrol-api-t442105/CS/SchedulerControl_WPF_API/CodeExamples/AppointmentConflicts.cs#L16

Appointment apt1 = scheduler.Storage.AppointmentStorage.CreateAppointment(AppointmentType.Normal, DateTime.Now, DateTime.Now.AddHours(2));
apt1.ResourceId = scheduler.Storage.ResourceStorage[0].Id;
scheduler.Storage.AppointmentStorage.Add(apt1);

how-to-show-color-icons-for-labels-and-statuses-in-the-appointment-edit-form-and-popup-menu-t344486/CS/CustomFormStatusEditors/DevExpress/ASPxSchedulerForms/AppointmentForm.ascx.cs#L100

else {
    if(!Object.Equals(apt.ResourceId, EmptyResourceId.Id))
        edtResource.Value = apt.ResourceId.ToString();

VB.NET

how-to-separate-shift-conflicted-appointments-while-dragging-another-appointment-e5007/VB/WindowsFormsApplication1/Form1.vb#L142

Dim dragAppointmentInterval As New TimeInterval(e.SourceAppointment.Start, e.SourceAppointment.End)
ReOrderOtherAppointments(e.SourceAppointment.ResourceId, dragAppointmentInterval, e.SourceAppointment)
Return True

winforms-schedulercontrol-api-t224044/VB/SchedulerAPISample/CodeExamples/AppointmentConflicts.vb#L20

Dim apt1 As Appointment = scheduler.DataStorage.Appointments.CreateAppointment(AppointmentType.Normal, Date.Now, Date.Now.AddHours(2))
apt1.ResourceId = scheduler.DataStorage.Resources(0).Id
scheduler.DataStorage.Appointments.Add(apt1)

how-to-build-a-layout-similar-to-ms-outlook-calendar-in-overlay-mode-with-schedulercontrol-t191172/VB/SchedulerOverlay/Form1.vb#L60

Dim appointmentResourceName As String = String.Empty
If Not (TypeOf info.Appointment.ResourceId Is EmptyResourceId) Then
    appointmentResourceName = schedulerStorage.Resources(CInt((info.Appointment.ResourceId))).Caption

wpf-schedulercontrol-api-t442105/VB/SchedulerControl_WPF_API/CodeExamples/AppointmentConflicts.vb#L15

Dim apt1 As Appointment = scheduler.Storage.AppointmentStorage.CreateAppointment(AppointmentType.Normal, Date.Now, Date.Now.AddHours(2))
apt1.ResourceId = scheduler.Storage.ResourceStorage(0).Id
scheduler.Storage.AppointmentStorage.Add(apt1)

how-to-show-color-icons-for-labels-and-statuses-in-the-appointment-edit-form-and-popup-menu-t344486/VB/CustomFormStatusEditors/DevExpress/ASPxSchedulerForms/AppointmentForm.ascx.vb#L107

Else
    If Not Object.Equals(apt.ResourceId, EmptyResourceId.Id) Then
        edtResource.Value = apt.ResourceId.ToString()