ReportingService2010::SetExecutionOptions Method (String^, String^, ScheduleDefinitionOrReference^)


Sets execution options and associated execution properties for a specified item. This method applies to the Report item type.

Namespace:   ReportService2010
Assembly:  ReportService2010 (in ReportService2010.dll)

	RequestNamespace = "", 
	ResponseNamespace = "", 
	Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
void SetExecutionOptions(
	String^ ItemPath,
	String^ ExecutionSetting,
	ScheduleDefinitionOrReference^ Item


Type: System::String^

The fully qualified URL of the item including the file name and, in SharePoint mode, the extension.

Type: System::String^

A string that describes when the item executes. The value can be either Live or Snapshot.

Type: ReportService2010::ScheduleDefinitionOrReference^

The schedule definition or shared schedule (ScheduleDefinitionOrReference object) that the report server uses to execute an item on a schedule.

The table below shows header and permissions information on this operation.

SOAP Header Usage

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

Native Mode Required Permissions


SharePoint Mode Required Permissions


The Item parameter is valid only if the value of the ExecutionSetting parameter is Snapshot. Set the value of Item to null (Nothing in Visual Basic) if ExecutionSetting is set to Live. If you are using a shared schedule, set the value of Item to a ScheduleReference object that references an existing shared schedule. If you are defining a unique schedule, set the value of Item to the ScheduleDefinition object that defines a unique schedule. If the execution options for an item are based on a shared schedule and that shared schedule is deleted, the schedule is then associated with the individual item.

If you change the value of ExecutionSetting from Live to Snapshot, the item is removed from the cache.

No code example is currently available or this language may not be supported.
Return to top