Instance Property


A collection of either property descriptions or string property names that specify which properties should be returned by the fetch.


@property(nonatomic, copy) NSArray *propertiesToFetch;


Property descriptions can either be instances of NSPropertyDescription or NSString. The property descriptions may represent attributes, to-one relationships, or expressions. The name of an attribute or relationship description must match the name of a description on the fetch request’s entity.

Special Considerations

You must set the entity for the fetch request before setting this value; otherwise, NSFetchRequest throws an NSInvalidArgumentException exception.

This property can be set with NSManagedObjectResultType and thereby implement a partial faulting (whereby only some of the properties are populated) of the returned objects, as well as the NSDictionaryResultType to define what properties are included in the resulting NSDictionary.

See Also

Managing How Results Are Returned


The result type of the fetch request.


A Boolean value that indicates whether, when the fetch is executed, it matches against currently unsaved changes in the managed object context.


A Boolean value that indicates whether the fetch request returns only distinct values for the fields specified by propertiesToFetch.


A Boolean value that indicates whether, when the fetch is executed, property data is obtained from the persistent store.


A Boolean value that indicates whether the property values of fetched objects will be updated with the current values in the persistent store.


A Boolean value that indicates whether the objects resulting from a fetch request are faults.


Constants that specify the possible result types a fetch request can return.


An abstract protocol used with parameterized fetch requests.