---
title: propertiesToFetch
framework: coredata
role: symbol
role_heading: Instance Property
path: coredata/nsfetchrequest/propertiestofetch
---

# propertiesToFetch

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

## Declaration

```swift
var propertiesToFetch: [Any]? { get set }
```

## Discussion

Discussion 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 invalidArgumentException exception. This property can be set with managedObjectResultType and thereby implement a partial faulting (whereby only some of the properties are populated) of the returned objects, as well as the dictionaryResultType to define what properties are included in the resulting NSDictionary.

## See Also

### Managing How Results Are Returned

- [resultType](coredata/nsfetchrequest/resulttype.md)
- [includesPendingChanges](coredata/nsfetchrequest/includespendingchanges.md)
- [returnsDistinctResults](coredata/nsfetchrequest/returnsdistinctresults.md)
- [includesPropertyValues](coredata/nsfetchrequest/includespropertyvalues.md)
- [shouldRefreshRefetchedObjects](coredata/nsfetchrequest/shouldrefreshrefetchedobjects.md)
- [returnsObjectsAsFaults](coredata/nsfetchrequest/returnsobjectsasfaults.md)
- [NSFetchRequestResultType](coredata/nsfetchrequestresulttype.md)
- [NSFetchRequestResult](coredata/nsfetchrequestresult.md)