Task class

Represents a Task item. Properties available on tasks are defined in the TaskSchema class.

Inheritance

• Object
• ServiceObject
• Item
• Task

Constructors

Task(ExchangeService service)

Initializes an unsaved local instance of

Task.withAttachment(ItemAttachment parentAttachment)

Initializes a new instance of the

Properties

ActualWork ↔ int?

Gets or sets the actual amount of time that is spent on the task.

getter/setter pair

AssignedTime → DateTime?

Gets the date and time the task was assigned.

no setter

Attachments → AttachmentCollection

Gets a list of the attachments to this item.

no setter, inherited

BillingInformation ↔ String?

Gets or sets the billing information of the task.

getter/setter pair

Body ↔ MessageBody?

Gets or sets the body of this item.

getter/setter pair, inherited

Categories ↔ StringList

Gets or sets the list of categories associated with this item.

getter/setter pair, inherited

ChangeCount → int?

Gets the number of times the task has changed since it was created.

no setter

Companies ↔ StringList

Gets or sets a list of companies associated with the task.

getter/setter pair

CompleteDate ↔ DateTime?

Gets or sets the date and time on which the task was completed.

getter/setter pair

Contacts ↔ StringList

Gets or sets a list of contacts associated with the task.

getter/setter pair

DateTimeCreated → DateTime?

Gets the date and time this item was created.

no setter, inherited

DateTimeReceived → DateTime?

Gets the time when this item was received.

no setter, inherited

DateTimeSent → DateTime?

Gets a list of Internet headers for this item.

no setter, inherited

DefaultAffectedTaskOccurrences → AffectedTaskOccurrence

Gets the default setting for how to treat affected task occurrences on Delete.

no setter, override

DefaultSendCancellationsMode → SendCancellationsMode?

Gets the default setting for sending cancellations on Delete. Subclasses will override this for different default behavior.

no setter, inherited

DefaultSendInvitationsMode → SendInvitationsMode?

Gets the default settings for sending invitations on Save. Subclasses will override this for different default behavior.

no setter, inherited

DefaultSendInvitationsOrCancellationsMode → SendInvitationsOrCancellationsMode?

Gets the default settings for sending invitations or cancellations on Update. Subclasses will override this for different default behavior.

no setter, inherited

DelegationState → TaskDelegationState?

Gets the current delegation state of the task.

no setter

Delegator → String?

Gets the name of the delegator of this task.

no setter

DueDate ↔ DateTime?

Gets or sets the date and time on which the task is due.

getter/setter pair

EffectiveRights → Set<EffectiveRights>?

Gets a value indicating the effective rights the current authenticated user has on this item.

no setter, inherited

ExtendedProperties → ExtendedPropertyCollection

Gets a list of extended properties defined on this item.

no setter, inherited

HasAttachments → bool?

Gets or sets the number of minutes before the start of this item when the reminder should be triggered.

no setter, inherited

hashCode → int

The hash code for this object.

no setter, inherited

ICalUid → String?

no setter, inherited

Id → ItemId?

Gets the Id of this item.

no setter, inherited

Importance ↔ Importance?

Gets or sets the culture associated with this item.

getter/setter pair, inherited

InstanceKey → Uint8List?

Gets the item instance key.

no setter, inherited

IsAssociated → bool?

Gets a value indicating whether this is an associated item.

no setter, inherited

IsAttachment → bool

Gets a value indicating whether the item is an attachment.

no setter, inherited

IsComplete → bool?

Gets a value indicating whether the task is complete.

no setter

IsDirty → bool

Gets a value indicating whether the object has been modified and should be saved.

no setter, inherited

IsDraft → bool?

Gets a value indicating whether the item is is a draft. An item is a draft when it has not yet been sent.

no setter, inherited

IsFromMe → bool?

Gets a value indicating whether the item has been sent by the current authenticated user.

no setter, inherited

IsNew → bool

Gets a value indicating whether this object is a real store item, or if it's a local object that has yet to be saved.

no setter, inherited

IsRecurring → bool?

Gets a value indicating whether the task is recurring.

no setter

IsReminderSet ↔ bool?

Gets or sets a value indicating whether a reminder is set for this item.

getter/setter pair, inherited

IsResend → bool?

Gets a value indicating whether the item is a resend of another item.

no setter, inherited

IsSubmitted → bool?

Gets or sets the In-Reply-To reference of this item.

no setter, inherited

IsTeamTask → bool?

Gets a value indicating whether the task is a team task.

no setter

IsUnmodified → bool?

Gets a value indicating whether the item has been modified since it was created.

no setter, inherited

ItemClass ↔ String?

Gets or sets the custom class name of this item.

getter/setter pair, inherited

LastModifiedName → String?

Gets the name of the user who last modified this item.

no setter, inherited

LastModifiedTime → DateTime?

Gets the date and time this item was last modified.

no setter, inherited

Mileage ↔ String?

Gets or sets the mileage of the task.

getter/setter pair

MimeContent ↔ MimeContent?

Get or sets the MIME content of this item.

getter/setter pair, inherited

Mode → TaskMode?

Gets a value indicating the mode of the task.

no setter

onChange ↔ List<IServiceObjectChangedDelegate>

Defines an event that is triggered when the service object changes.

getter/setter pair, inherited

Owner → String?

Gets the name of the owner of the task.

no setter

ParentAttachment → ItemAttachment?

Gets the parent attachment of this item.

no setter, inherited

ParentFolderId → FolderId?

Get or sets the MimeContentUTF8 of this item.

no setter, inherited

PercentComplete ↔ double?

Gets or sets the completeion percentage of the task. PercentComplete must be between 0 and 100.

getter/setter pair

Preview → String?

Get or set the Flag value for this item.

no setter, inherited

PropertyBag → PropertyBag

The property bag holding property values for this object.

no setter, inherited

Recurrence ↔ Recurrence?

Gets or sets the recurrence pattern for this task. Available recurrence pattern classes include Recurrence.DailyPattern, Recurrence.MonthlyPattern and Recurrence.YearlyPattern.

getter/setter pair

ReminderDueBy ↔ DateTime?

Gets a value indicating which response actions are allowed on this item. Examples of response actions are Reply and Forward.

getter/setter pair, inherited

RootItemId → ItemId?

Gets Id of the root item for this item.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Schema → ServiceObjectSchema

Gets the schema associated with this type of object.

no setter, inherited

Sensitivity ↔ Sensitivity?

Gets or sets the sensitivity of this item.

getter/setter pair, inherited

Service ↔ ExchangeService

Gets the ExchangeService the object is bound to.

getter/setter pair, inherited

Size → int?

Gets the size of this item.

no setter, inherited

StartDate ↔ DateTime?

Gets or sets the date and time on which the task starts.

getter/setter pair

Status ↔ TaskStatus?

Gets or sets the status of the task.

getter/setter pair

StatusDescription → String?

Gets a String representing the status of the task, localized according to the PreferredCulture property of the ExchangeService object the task is bound to.

no setter

StoreEntryId → Uint8List?

Gets the store entry id.

no setter, inherited

Subject ↔ String?

Gets or sets the subject of this item.

getter/setter pair, inherited

TextBody → TextBody?

Gets the text body of the item.

no setter, inherited

TotalWork ↔ int?

Gets or sets the total amount of work spent on the task.

getter/setter pair

UniqueBody → UniqueBody?

Gets the Id of the conversation this item is part of.

no setter, inherited

WebClientEditFormQueryString → String?

no setter, inherited

WebClientReadFormQueryString → String?

no setter, inherited

Methods

Changed() → void

Triggers dispatch of the change event.

inherited

ClearChangeLog() → void

Clears the object's change log.

inherited

Delete(DeleteMode deleteMode, [bool suppressReadReceipts = false]) → Future<void>

Deletes the item. Calling this method results in a call to EWS.

inherited

DeleteCurrentOccurrence(DeleteMode deleteMode) → void

Deletes the current occurrence of a recurring task. After the current occurrence isdeleted, the task represents the next occurrence. Developers should call Load to retrieve the new property values of the task. Calling this method results in a call to EWS.

GetChangeXmlElementName() → String

Gets the name of the change XML element.

inherited

GetDeleteFieldXmlElementName() → String

Gets the name of the delete field XML element.

inherited

GetExtendedProperties() → ExtendedPropertyCollection?

Gets a list of extended properties defined on this object.

inherited

GetId() → ServiceId?

The unique Id of this object.

inherited

GetIdPropertyDefinition() → PropertyDefinition

The property definition for the Id of this object.

inherited

GetIsCustomDateTimeScopingRequired() → bool

Determines whether properties defined with ScopedDateTimePropertyDefinition require custom time zone scoping.

inherited

GetIsTimeZoneHeaderRequired(bool isUpdateOperation) → bool

Gets a value indicating whether a time zone SOAP header should be emitted in a CreateItem or UpdateItem request so this item can be property saved or updated.

override

GetLoadedPropertyDefinitions() → List<PropertyDefinitionBase?>

Gets the collection of loaded property definitions.

inherited

GetMinimumRequiredServerVersion() → ExchangeVersion

Gets the minimum required server version.

override

GetSchema() → ServiceObjectSchema

method to return the schema associated with this type of object.

override

getServiceObjectDefinitionAttribute() → ServiceObjectDefinitionAttribute

override

GetSetFieldXmlElementName() → String

Gets the name of the set field XML element.

inherited

GetXmlElementName() → String?

GetXmlElementName retrieves the XmlElementName of this type based on the EwsObjectDefinition attribute that decorates it, if present.

inherited

GetXmlElementNameOverride() → String?

This methods lets subclasses of ServiceObject override the default mechanism by which the XML element name associated with their type is retrieved.

inherited

HasUnprocessedAttachmentChanges() → bool

Gets a value indicating whether this instance has unprocessed attachment collection changes.

inherited

InternalCreate(FolderId? parentFolderId, MessageDisposition? messageDisposition, SendInvitationsMode? sendInvitationsMode) → Future<void>

Create item.

inherited

InternalDelete(DeleteMode deleteMode, SendCancellationsMode? sendCancellationsMode, AffectedTaskOccurrence? affectedTaskOccurrences, [bool suppressReadReceipts = false]) → Future<void>

Deletes the object.

inherited

InternalLoad(PropertySet propertySet) → Future<void>

Loads the specified set of properties on the object.

inherited

InternalUpdate(FolderId? parentFolderId, ConflictResolutionMode conflictResolutionMode, MessageDisposition messageDisposition, SendInvitationsOrCancellationsMode? sendInvitationsOrCancellationsMode, [bool suppressReadReceipts = false]) → Future<Item?>

Update item.

inherited

Load() → Future<void>

Loads the first class properties. Calling this method results in a call to EWS.

inherited

LoadFromXml(EwsServiceXmlReader reader, bool clearPropertyBag) → Future<void>

Loads service object from XML.

inherited

LoadFromXmlWithPropertySet(EwsServiceXmlReader reader, bool clearPropertyBag, PropertySet? requestedPropertySet, bool summaryPropertiesOnly) → Future<void>

Loads service object from XML.

inherited

LoadWithPropertySet(PropertySet propertySet) → Future<void>

Loads the specified set of properties. Calling this method results in a call to EWS.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

RemoveExtendedProperty(ExtendedPropertyDefinition extendedPropertyDefinition) → bool

Removes an extended property.

inherited

Save() → Future<void>

Saves this item in the default folder based on the item's type (for example, an e-mail message is saved to the Drafts folder). Calling this method results in at least one call to EWS. Mutliple calls to EWS might be made if attachments have been added.

inherited

SaveWithFolderId(FolderId? parentFolderId) → Future<void>

Saves this item in a specific folder. Calling this method results in at least one call to EWS. Mutliple calls to EWS might be made if attachments have been added.

inherited

SaveWithWellKnownFolderName(WellKnownFolderName parentFolderName) → Future<void>

Saves this item in a specific folder. Calling this method results in at least one call to EWS. Mutliple calls to EWS might be made if attachments have been added.

inherited

SetExtendedProperty(ExtendedPropertyDefinition extendedPropertyDefinition, Object value) → void

Creates a copy of this item in the specified folder. Calling this method results in a call to EWS.

inherited

SetSubject(String? subject) → void

Sets the subject.

inherited

ThrowIfThisIsAttachment() → void

Throws exception if this is attachment.

inherited

ThrowIfThisIsNew() → void

Throws exception if this is a new service object.

inherited

ThrowIfThisIsNotNew() → void

Throws exception if this is not a new service object.

inherited

toString() → String

A string representation of this object.

inherited

TryGetExtendedProperty<T>(ExtendedPropertyDefinition propertyDefinition, OutParam<T> propertyValueOutParam) → bool

Try to get the value of a specified extended property in this instance.

inherited

TryGetProperty(PropertyDefinitionBase propertyDefinition, OutParam<Object> propertyValueOutParam) → bool

Try to get the value of a specified property in this instance.

inherited

TryGetPropertyGeneric<T>(PropertyDefinitionBase propertyDefinition, OutParam<T> propertyValueOutParam) → bool

Try to get the value of a specified property in this instance.

inherited

Update(ConflictResolutionMode conflictResolutionMode, [bool suppressReadReceipts = false]) → Future<Task?>

Applies the local changes that have been made to this task. Calling this method results in at least one call to EWS. Mutliple calls to EWS might be made if attachments have been added or removed.

override

Validate() → void

Validates this instance.

inherited

WriteToXml(EwsServiceXmlWriter writer) → void

Writes service object as XML.

inherited

WriteToXmlForUpdate(EwsServiceXmlWriter writer) → void

Writes service object for update as XML.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

operator [](PropertyDefinitionBase propertyDefinition) → Object?

Gets the value of specified property in this instance.

inherited

Static Methods

BindWithItemId(ExchangeService service, ItemId? id) → Future<Task>

Binds to an existing task and loads its first class properties. Calling this method results in a call to EWS.

BindWithPropertySet(ExchangeService service, ItemId? id, PropertySet propertySet) → Future<Task>

Binds to an existing task and loads the specified set of properties. Calling this method results in a call to EWS.

override