Appointment
Provides a complete implementation of the IAppointment interface with additional properties for comprehensive appointment management. This class serves as the standard appointment type for RadScheduler and includes commonly needed properties like Body, Location, UniqueId, and URL beyond the basic IAppointment requirements.
Definition
Namespace:Telerik.Maui.Controls.Scheduler
Assembly:Telerik.Maui.Controls.dll
Syntax:
public class Appointment : AppointmentBase, IAppointment, IDateRange, INotifyPropertyChanged, IEquatable<IAppointment>, ICopyable<IAppointment>, IExtendedAppointmentInheritance: objectNotifyPropertyChangedBaseAppointmentBaseAppointment
Implements:
Inherited Members
Constructors
Initializes a new instance of the Appointment class with default values. The constructor automatically generates a unique identifier and sets up the appointment for immediate use.
public Appointment()The constructor performs the following initialization:
- Generates a new GUID for the UniqueId property
- Sets default values for all properties (null for strings, current time zone for TimeZone if inherited)
- Prepares the object for property change notification
After construction, you should set at minimum the Start, End, and Subject properties before adding the appointment to a scheduler's AppointmentsSource collection.
Properties
Gets or sets the detailed description or body content of the appointment. This property provides space for extended information beyond the basic subject line.
public virtual string Body { get; set; }A string containing the appointment's detailed description, notes, or body text. Can be null or empty.
The Body property is useful for:
- Meeting agendas and detailed descriptions
- Notes and reminders about the appointment
- Participant information or preparation requirements
- Additional context that doesn't fit in the subject line
This information is typically displayed in:
- Appointment detail dialogs
- Tooltip popups when hovering over appointments
- Expanded views of appointments
- Print layouts and reports
Gets or sets the location where the appointment takes place. This can represent physical locations, virtual meeting rooms, or any venue information relevant to the appointment.
public string Location { get; set; }A string containing the appointment's location information. Can be null or empty.
The Location property supports various types of location information:
- Physical addresses: "123 Main St, New York, NY"
- Room names: "Conference Room A", "Building 2, Floor 3"
- Virtual locations: "Zoom Meeting", "Microsoft Teams"
- General areas: "Downtown Office", "Client Site"
Location information may be used for:
- Display in appointment tooltips and details
- Integration with mapping services
- Resource booking and conflict detection
- Travel time calculations between appointments
Gets or sets the unique identifier for this appointment instance. This property provides a consistent way to identify and track appointments across different operations and storage systems.
public string UniqueId { get; set; }A string containing a unique identifier, typically a GUID. Automatically generated during construction.
The UniqueId serves several important purposes:
- Database primary keys and foreign key relationships
- Synchronization between different systems or devices
- Tracking appointments through various operations (edit, delete, copy)
- Integration with external calendar systems
- Debugging and logging operations
The value is automatically generated as a new GUID when an appointment is created, ensuring uniqueness across all appointment instances. You can override this value if integrating with external systems that provide their own identifiers.
Gets or sets a URL associated with the appointment. This property can store web links related to the appointment such as meeting URLs, document links, or reference materials.
public string Url { get; set; }A string containing a URL or web link. Can be null or empty.
The URL property supports various types of web links:
- Video conference links: Zoom, Teams, WebEx meeting URLs
- Document links: Shared documents, agendas, presentations
- Reference materials: Websites, articles, resources related to the appointment
- Integration links: Deep links to other applications or systems
Common use cases:
- Online meeting appointments with join URLs
- Training sessions with material links
- Appointments with associated documentation
- Integration with web-based applications
The URL can be used by the UI to provide clickable links or by integration code to launch external applications or browsers.
Methods
Deep copies all properties from other to this Appointment.
public override void CopyFrom(IAppointment other)The Appointment which properties are copied.
Overrides:
Indicates whether the current object is equal to another object of the same type.