Package microsoft.exchange.webservices.data.core.service.folder

Class SearchFolder

java.lang.Object

microsoft.exchange.webservices.data.core.service.ServiceObject

microsoft.exchange.webservices.data.core.service.folder.Folder

microsoft.exchange.webservices.data.core.service.folder.SearchFolder

public class SearchFolder
extends Folder

Represents a search folder.

Constructor Summary

Constructors

Constructor	Description
SearchFolder(ExchangeService service)	Initializes an unsaved local instance of the class.

Method Summary

Modifier and Type	Method	Description
static SearchFolder	bind(ExchangeService service, WellKnownFolderName name)	Binds to an existing search folder and loads the specified set of property.
static SearchFolder	bind(ExchangeService service, WellKnownFolderName name, PropertySet propertySet)	Binds to an existing search folder and loads the specified set of property.
static SearchFolder	bind(ExchangeService service, FolderId id)	Binds to an existing search folder and loads its first class property.
static SearchFolder	bind(ExchangeService service, FolderId id, PropertySet propertySet)	Binds to an existing search folder and loads the specified set of property.
ExchangeVersion	getMinimumRequiredServerVersion()	Gets the minimum required server version.
ServiceObjectSchema	getSchema()	Internal method to return the schema associated with this type of object.
SearchFolderParameters	getSearchParameters()	Gets the search parameters associated with the search folder.
void	validate()	Validates this instance.

Methods inherited from class microsoft.exchange.webservices.data.core.service.folder.Folder

copy, copy, delete, empty, findFolders, findFolders, findItems, findItems, findItems, findItems, findItems, findItems, getChangeXmlElementName, getChildFolderCount, getDeleteFieldXmlElementName, getDisplayName, getEffectiveRights, getExtendedProperties, getExtendedPropertiesForService, getFolderClass, getId, getIdPropertyDefinition, getManagedFolderInformation, getParentFolderId, getPermissions, getSetFieldXmlElementName, getTotalCount, getUnreadCount, getWellKnownFolderName, internalDelete, internalLoad, move, move, removeExtendedProperty, save, save, setDisplayName, setExtendedProperty, setFolderClass, update

Methods inherited from class microsoft.exchange.webservices.data.core.service.ServiceObject

addServiceObjectChangedEvent, changed, clearChangeLog, clearServiceObjectChangedEvent, getIsCustomDateTimeScopingRequired, getIsTimeZoneHeaderRequired, getLoadedPropertyDefinitions, getObjectFromPropertyDefinition, getPropertyBag, getService, getXmlElementName, getXmlElementNameOverride, isDirty, isNew, load, load, loadFromXml, loadFromXml, removeServiceObjectChangedEvent, schema, setService, throwIfThisIsNew, throwIfThisIsNotNew, tryGetExtendedProperty, tryGetProperty, tryGetProperty, writeToXml, writeToXmlForUpdate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SearchFolder

public SearchFolder(ExchangeService service)
             throws Exception

Initializes an unsaved local instance of the class. To bind to an existing search folder, use SearchFolder.Bind() instead.

Parameters:

service - the service

Throws:

Exception - the exception

Method Detail

bind

public static SearchFolder bind(ExchangeService service,
                                FolderId id,
                                PropertySet propertySet)
                         throws Exception

Binds to an existing search folder and loads the specified set of property. Calling this method results in a call to EWS.

Parameters:

service - the service

id - the id

propertySet - the property set

Returns:

A SearchFolder instance representing the search folder corresponding to the specified Id.

Throws:

Exception - the exception

bind

public static SearchFolder bind(ExchangeService service,
                                FolderId id)
                         throws Exception

Binds to an existing search folder and loads its first class property. Calling this method results in a call to EWS.

Parameters:

service - the service

id - the id

Returns:

A SearchFolder instance representing the search folder corresponding to the specified Id.

Throws:

Exception - the exception

bind

public static SearchFolder bind(ExchangeService service,
                                WellKnownFolderName name,
                                PropertySet propertySet)
                         throws Exception

Binds to an existing search folder and loads the specified set of property. Calling this method results in a call to EWS.

Parameters:

service - the service

name - the name

propertySet - the property set

Returns:

A SearchFolder instance representing the search folder with the specified name.

Throws:

Exception - the exception

bind

public static SearchFolder bind(ExchangeService service,
                                WellKnownFolderName name)
                         throws Exception

Binds to an existing search folder and loads the specified set of property. Calling this method results in a call to EWS.

Parameters:

service - the service

name - the name

Returns:

A SearchFolder instance representing the search folder with the specified name.

Throws:

Exception - the exception

getSchema

public ServiceObjectSchema getSchema()

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

Overrides:

getSchema in class Folder

Returns:

The schema associated with this type of object.

validate

public void validate()
              throws Exception

Validates this instance.

Overrides:

validate in class Folder

Throws:

Exception - the exception

getMinimumRequiredServerVersion

public ExchangeVersion getMinimumRequiredServerVersion()

Gets the minimum required server version.

Overrides:

getMinimumRequiredServerVersion in class Folder

Returns:

Earliest Exchange version in which this service object type is supported.

getSearchParameters

public SearchFolderParameters getSearchParameters()
                                           throws Exception

Gets the search parameters associated with the search folder.

Returns:

the search parameters

Throws:

Exception - the exception