Share via


UIDocument Class

Definition

Abstract base class providing local and cloud-based management of Model data.

[Foundation.Register("UIDocument", true)]
public class UIDocument : Foundation.NSObject, Foundation.INSFilePresenter, Foundation.INSProgressReporting, IDisposable, UIKit.IUIUserActivityRestoring
[<Foundation.Register("UIDocument", true)>]
type UIDocument = class
    inherit NSObject
    interface INSFilePresenter
    interface INativeObject
    interface IDisposable
    interface INSProgressReporting
    interface IUIUserActivityRestoring
Inheritance
UIDocument
Derived
Attributes
Implements

Remarks

Application developers can subclass UIDocument to create objects that are "Model-Controllers" and relate to Model (domain) objects analogously to how UIViewController relate to UIViews. UIKit provides a number of functions, including background asynchronous reading and writing of application data, automatic and safe data-saving, storage that is automatically coordinated between the application sandbox and cloud services, etc.

At a minimum, application developers need to implement ContentsForType(String, NSError) (for storage) and LoadFromContents(NSObject, String, NSError) (for retrieval). Additionally, application developers need to manage the lifecyle of the UIDocument and this requires the application developer to set the preferred storage location, create a file URL, and discover, open, and close the file. Application developers should also track changes and resolve conflicts between document versions.

The members of this class can be used from a background thread.

Constructors

Name Description
UIDocument(NativeHandle)

A constructor used when creating managed representations of unmanaged objects. Called by the runtime.

UIDocument(NSObjectFlag)

Constructor to call on derived classes to skip initialization and merely allocate the object.

UIDocument(NSUrl)

Properties

Name Description
AccessibilityAttributedUserInputLabels (Inherited from NSObject)
AccessibilityRespondsToUserInteraction (Inherited from NSObject)
AccessibilityTextualContext (Inherited from NSObject)
AccessibilityUserInputLabels (Inherited from NSObject)
Class (Inherited from NSObject)
ClassHandle

The Objective-C class handle for this class.

DebugDescription (Inherited from NSObject)
Description (Inherited from NSObject)
DidMoveToWritableLocationNotification

Notification constant for DidMoveToWritableLocation

DidMoveToWritableLocationOldUrlKey

Represents the value associated with the constant 'UIDocumentDidMoveToWritableLocationOldURLKey'.

DocumentState
FileModificationDate
FileType
FileUrl
Handle

Handle (pointer) to the unmanaged object representation.

(Inherited from NSObject)
HasUnsavedChanges
IsDirectBinding (Inherited from NSObject)
IsProxy (Inherited from NSObject)
LocalizedName
PresentedItemObservedUbiquityAttributes

Gets the set of ubiquity attributes that will generate notifications if they are modified.

PresentedItemOperationQueue

Gets the NSOperationQueue on which presenter-related methods are executed.

PresentedItemUrl

Gets URL of presented item.

Progress
RetainCount (Inherited from NSObject)
SavingFileType
Self (Inherited from NSObject)
StateChangedNotification

Notification constant for StateChanged

Superclass (Inherited from NSObject)
SuperHandle

Handle used to represent the methods in the base class for this NSObject.

(Inherited from NSObject)
UndoManager
UserActivity
UserActivityDocumentUrlKey

Gets the key that specifies the document's URL in the UserActivity property.

Zone (Inherited from NSObject)

Methods

Name Description
AccommodatePresentedItemDeletion(Action<NSError>)
AccommodatePresentedItemEviction(Action<NSError>)
AccommodatePresentedSubitemDeletion(NSUrl, Action<NSError>)
AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr) (Inherited from NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr) (Inherited from NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)

Registers an object for being observed externally using an arbitrary method.

(Inherited from NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)

Registers an object for being observed externally using an arbitrary method.

(Inherited from NSObject)
AutoSave(UIOperationHandler)
AutoSaveAsync()

Called by the system immediately prior to automatic saving of UIDocuments with unsaved changes.

AwakeFromNib() (Inherited from NSObject)
BeginInvokeOnMainThread(Action) (Inherited from NSObject)
BeginInvokeOnMainThread(Selector, NSObject)

Invokes asynchrously the specified code on the main UI thread.

(Inherited from NSObject)
ChangeCountTokenForSaveOperation(UIDocumentSaveOperation)
Close(UIOperationHandler)
CloseAsync()

Asynchronously closes the document after saving any changes.

ConformsToProtocol(NativeHandle) (Inherited from NSObject)
ContentsForType(String, NSError)
Copy() (Inherited from NSObject)
DangerousAutorelease()

Calls the 'autorelease' selector on this object.

(Inherited from NSObject)
DangerousRelease()

Calls the 'release' selector on this object.

(Inherited from NSObject)
DangerousRetain()

Calls the 'retain' selector on this object.

(Inherited from NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString) (Inherited from NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet) (Inherited from NSObject)
DidChangeValue(String) (Inherited from NSObject)
DisableEditing()
Dispose()

Releases the resources used by the NSObject object.

(Inherited from NSObject)
Dispose(Boolean)

Releases the resources used by the NSObject object.

(Inherited from NSObject)
DoesNotRecognizeSelector(Selector) (Inherited from NSObject)
EnableEditing()
Equals(NSObject) (Inherited from NSObject)
Equals(Object) (Inherited from NSObject)
FinishedHandlingError(NSError, Boolean)
GetDictionaryOfValuesFromKeys(NSString[]) (Inherited from NSObject)
GetFileAttributesToWrite(NSUrl, UIDocumentSaveOperation, NSError)
GetFileNameExtension(String, UIDocumentSaveOperation)
GetHashCode()

Generates a hash code for the current instance.

(Inherited from NSObject)
GetMethodForSelector(Selector) (Inherited from NSObject)
GetNativeHash() (Inherited from NSObject)
HandleError(NSError, Boolean)
Init() (Inherited from NSObject)
InitializeHandle(NativeHandle, String) (Inherited from NSObject)
InitializeHandle(NativeHandle) (Inherited from NSObject)
Invoke(Action, Double) (Inherited from NSObject)
Invoke(Action, TimeSpan) (Inherited from NSObject)
InvokeOnMainThread(Action) (Inherited from NSObject)
InvokeOnMainThread(Selector, NSObject)

Invokes synchrously the specified code on the main UI thread.

(Inherited from NSObject)
IsEqual(NSObject) (Inherited from NSObject)
IsKindOfClass(Class) (Inherited from NSObject)
IsMemberOfClass(Class) (Inherited from NSObject)
LoadFromContents(NSObject, String, NSError)
MarkDirty()

Promotes a regular peer object (IsDirectBinding is true) into a toggleref object.

(Inherited from NSObject)
MutableCopy() (Inherited from NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr) (Inherited from NSObject)
Open(UIOperationHandler)
OpenAsync()

Asynchronously opens a document.

PerformAsynchronousFileAccess(Action)
PerformAsynchronousFileAccessAsync()

Performs an asynchronous file access action.

PerformSelector(Selector, NSObject, Double, NSString[]) (Inherited from NSObject)
PerformSelector(Selector, NSObject, Double) (Inherited from NSObject)
PerformSelector(Selector, NSObject, NSObject) (Inherited from NSObject)
PerformSelector(Selector, NSObject) (Inherited from NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[]) (Inherited from NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean) (Inherited from NSObject)
PerformSelector(Selector) (Inherited from NSObject)
PrepareForInterfaceBuilder() (Inherited from NSObject)
PresentedItemChanged()
PresentedItemChangedUbiquityAttributes(NSSet<NSString>)
PresentedItemGainedVersion(NSFileVersion)
PresentedItemLostVersion(NSFileVersion)
PresentedItemMoved(NSUrl)
PresentedItemResolveConflictVersion(NSFileVersion)
PresentedSubitemAppeared(NSUrl)
PresentedSubitemChanged(NSUrl)
PresentedSubitemGainedVersion(NSUrl, NSFileVersion)
PresentedSubitemLostVersion(NSUrl, NSFileVersion)
PresentedSubitemMoved(NSUrl, NSUrl)
PresentedSubitemResolvedConflictVersion(NSUrl, NSFileVersion)
Read(NSUrl, NSError)
RelinquishPresentedItemToReader(NSFilePresenterReacquirer)
RelinquishPresentedItemToWriter(NSFilePresenterReacquirer)
RemoveObserver(NSObject, NSString, IntPtr) (Inherited from NSObject)
RemoveObserver(NSObject, NSString) (Inherited from NSObject)
RemoveObserver(NSObject, String, IntPtr) (Inherited from NSObject)
RemoveObserver(NSObject, String) (Inherited from NSObject)
RespondsToSelector(Selector) (Inherited from NSObject)
RestoreUserActivityState(NSUserActivity)
RevertToContentsOfUrl(NSUrl, UIOperationHandler)
RevertToContentsOfUrlAsync(NSUrl)

Reverts the UIDocument to the most recent document data stored on-disk.

Save(NSUrl, UIDocumentSaveOperation, UIOperationHandler)
SaveAsync(NSUrl, UIDocumentSaveOperation)

Saves the document data to the specified location in the application sandbox.

SavePresentedItemChanges(Action<NSError>)
SetNilValueForKey(NSString) (Inherited from NSObject)
SetValueForKey(NSObject, NSString) (Inherited from NSObject)
SetValueForKeyPath(NativeHandle, NSString) (Inherited from NSObject)
SetValueForKeyPath(NSObject, NSString) (Inherited from NSObject)
SetValueForUndefinedKey(NSObject, NSString) (Inherited from NSObject)
SetValuesForKeysWithDictionary(NSDictionary) (Inherited from NSObject)
ToString()

Returns a string representation of the value of the current instance.

(Inherited from NSObject)
UpdateChangeCount(NSObject, UIDocumentSaveOperation)
UpdateChangeCount(UIDocumentChangeKind)
UpdateUserActivityState(NSUserActivity)
UserInteractionNoLongerPermittedForError(NSError)
ValueForKey(NSString) (Inherited from NSObject)
ValueForKeyPath(NSString) (Inherited from NSObject)
ValueForUndefinedKey(NSString) (Inherited from NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString) (Inherited from NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet) (Inherited from NSObject)
WillChangeValue(String) (Inherited from NSObject)
WriteContents(NSObject, NSDictionary, NSUrl, UIDocumentSaveOperation, NSError)
WriteContents(NSObject, NSUrl, UIDocumentSaveOperation, NSUrl, NSError)

Extension Methods

Name Description
BrowserAccessibilityDeleteTextAtCursor(NSObject, IntPtr)
BrowserAccessibilityInsertTextAtCursor(NSObject, String)
GetAccessibilityLineEndPositionFromCurrentSelection(NSObject)
GetAccessibilityLineRangeForPosition(NSObject, IntPtr)
GetAccessibilityLineStartPositionFromCurrentSelection(NSObject)
GetBrowserAccessibilityAttributedValue(NSObject, NSRange)
GetBrowserAccessibilityContainerType(NSObject)
GetBrowserAccessibilityCurrentStatus(NSObject)
GetBrowserAccessibilityHasDomFocus(NSObject)
GetBrowserAccessibilityIsRequired(NSObject)
GetBrowserAccessibilityPressedState(NSObject)
GetBrowserAccessibilityRoleDescription(NSObject)
GetBrowserAccessibilitySelectedTextRange(NSObject)
GetBrowserAccessibilitySortDirection(NSObject)
GetBrowserAccessibilityValue(NSObject, NSRange)
SetBrowserAccessibilityContainerType(NSObject, BEAccessibilityContainerType)
SetBrowserAccessibilityCurrentStatus(NSObject, String)
SetBrowserAccessibilityHasDomFocus(NSObject, Boolean)
SetBrowserAccessibilityIsRequired(NSObject, Boolean)
SetBrowserAccessibilityPressedState(NSObject, BEAccessibilityPressedState)
SetBrowserAccessibilityRoleDescription(NSObject, String)
SetBrowserAccessibilitySelectedTextRange(NSObject, NSRange)
SetBrowserAccessibilitySortDirection(NSObject, String)
ProvideImageData(NSObject, IntPtr, UIntPtr, UIntPtr, UIntPtr, UIntPtr, UIntPtr, NSObject)
ProvideImageToMTLTexture(NSObject, IMTLTexture, IMTLCommandBuffer, UIntPtr, UIntPtr, UIntPtr, UIntPtr, NSObject)
AccommodatePresentedItemDeletion(INSFilePresenter, Action<NSError>)
AccommodatePresentedItemEviction(INSFilePresenter, Action<NSError>)
AccommodatePresentedSubitemDeletion(INSFilePresenter, NSUrl, Action<NSError>)
GetPresentedItemObservedUbiquityAttributes(INSFilePresenter)

Gets the set of ubiquity attributes that will generate notifications if they are modified.

GetPrimaryPresentedItemUrl(INSFilePresenter)
PresentedItemChanged(INSFilePresenter)
PresentedItemChangedUbiquityAttributes(INSFilePresenter, NSSet<NSString>)
PresentedItemGainedVersion(INSFilePresenter, NSFileVersion)
PresentedItemLostVersion(INSFilePresenter, NSFileVersion)
PresentedItemMoved(INSFilePresenter, NSUrl)
PresentedItemResolveConflictVersion(INSFilePresenter, NSFileVersion)
PresentedSubitemAppeared(INSFilePresenter, NSUrl)
PresentedSubitemChanged(INSFilePresenter, NSUrl)
PresentedSubitemGainedVersion(INSFilePresenter, NSUrl, NSFileVersion)
PresentedSubitemLostVersion(INSFilePresenter, NSUrl, NSFileVersion)
PresentedSubitemMoved(INSFilePresenter, NSUrl, NSUrl)
PresentedSubitemResolvedConflictVersion(INSFilePresenter, NSUrl, NSFileVersion)
RelinquishPresentedItemToReader(INSFilePresenter, NSFilePresenterReacquirer)
RelinquishPresentedItemToWriter(INSFilePresenter, NSFilePresenterReacquirer)
SavePresentedItemChanges(INSFilePresenter, Action<NSError>)
SetSharedObservers(NSObject, NSKeyValueSharedObserversSnapshot)
GetDebugDescription(INSObjectProtocol)
GetHandle(INativeObject)
GetNonNullHandle(INativeObject, String)
GetAccessibilityCustomRotors(NSObject)

Gets the array of UIAccessibilityCustomRotor objects appropriate for this object.

SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])

Sets the array of UIAccessibilityCustomRotor objects appropriate for this object.

AccessibilityHitTest(NSObject, CGPoint, UIEvent)
GetAccessibilityNextTextNavigationElement(NSObject)
GetAccessibilityNextTextNavigationElementBlock(NSObject)
GetAccessibilityPreviousTextNavigationElement(NSObject)
GetAccessibilityPreviousTextNavigationElementBlock(NSObject)
SetAccessibilityNextTextNavigationElement(NSObject, NSObject)
SetAccessibilityNextTextNavigationElementBlock(NSObject, AXObjectReturnBlock)
SetAccessibilityPreviousTextNavigationElement(NSObject, NSObject)
SetAccessibilityPreviousTextNavigationElementBlock(NSObject, AXObjectReturnBlock)
GetAccessibilityTextInputResponder(NSObject)
GetAccessibilityTextInputResponderHandler(NSObject)
SetAccessibilityTextInputResponder(NSObject, IUITextInput)
SetAccessibilityTextInputResponderHandler(NSObject, UITextInputReturnHandler)

Applies to

See also