Instance Method

objectWithID:

Returns an object for a specified ID even if the object needs to be fetched.

Declaration

- (__kindof NSManagedObject *)objectWithID:(NSManagedObjectID *)objectID;

Parameters

objectID

An object ID.

Return Value

The object for the specified ID.

Discussion

If the object is not registered in the context, it may be fetched or returned as a fault. This method always returns an object. The data in the persistent store represented by objectID is assumed to exist—if it does not, the returned object throws an exception when you access any property (that is, when the fault is fired). The benefit of this behavior is that it allows you to create and use faults, then create the underlying data later or in a separate context.

See Also

Registering and Fetching Objects

- executeFetchRequest:error:

Returns an array of objects that meet the criteria specified by a given fetch request.

- countForFetchRequest:error:

Returns the number of objects a given fetch request would have returned if it had been passed to executeFetchRequest:error:.

- objectRegisteredForID:

Returns the object for a specified ID, if the object is registered with the context.

- existingObjectWithID:error:

Returns the object for the specified ID or nil if the object does not exist.

registeredObjects

The set of objects registered with the context.

- executeRequest:error:

Passes a request to the persistent store without affecting the contents of the managed object context and returns a persistent store result.

- refreshAllObjects

Refreshes all currently registered objects that are associated with this context.

retainsRegisteredObjects

A Boolean value that indicates whether the context keeps strong references to all registered managed objects.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software