CommonFileDialog Members

[This is preliminary documentation and is subject to change.]

The CommonFileDialog type exposes the following members.

Constructors

	Name	Description
	CommonFileDialog	Overloaded.

Methods

	Name	Description
	CheckFileNamesAvailable	Ensures that the user has selected one or more files.
	EndVisualGroup	End the visual group on the dialog
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnFileOk	Called just before the dialog is about to return with a result.
	OnFileTypeChanged	Called when the dialog is opened to notify the application of the initial chosen filetype.
	OnFolderChanged	Called when the user navigates to a new folder.
	OnFolderChanging	Called before OnFolderChanged(EventArgs). This allows the implementer to stop navigation to a particular location.
	OnOpening	Called when the dialog is opened.
	OnSelectionChanged	Called when the user changes the selection in the dialog's view.
	ResetUserSelections	Removes the current selection.
	ShowDialog	Displays the dialog.
	StartVisualGroup	Start the visual group on the dialog
	ThrowIfDialogShowing	Throws an exception when the dialog is showing preventing a requested change to a property or the visible set of controls.
	ToString	Returns a String that represents the current Object. (Inherited from Object.)

Fields

	Name	Description
	fileNames	The collection of names selected by the user.
	IllegalPropertyChangeString	Contains a common error message string shared by classes that inherit from this class.

Properties

	Name	Description
	AddExtension	Gets or sets a value that determines whether the file extension set via the DefaultExtension property is appended to the file name.
	AddToMruList	Gets or sets a value that controls whether to show or hide the list of places from which the user has recently opened or saved items.
	AllowPropertyEditing	Gets or sets a value that controls whether properties can be edited.
	CheckFileExists	Gets or sets a value to specify whether the file returned must exist.
	CheckPathExists	Gets or sets a value to specify whether the file returned must be in an existing folder.
	CheckReadOnly	Gets or sets a value that determines whether read-only items are returned.
	CheckValidNames	Gets or sets a value that controls validation of file names.
	Controls	Gets the collection of controls for the dialog.
	DefaultExtension	Gets or sets the default file extension to be added to file names.
	DereferenceLinks	Gets or sets a value that controls whether shortcuts should be treated as their target items, allowing an application to open a .lnk file.
	FileName	Gets the selected filename.
	Filters	Gets the filters used by the dialog.
	InitialDirectory	Gets or sets the initial directory displayed when the dialog is shown.
	RestoreDirectory	Corresponds to the FOS_NOCHANGEDIR file dialog option.
	ShowHiddenItems	Gets or sets a value that controls whether to show hidden items.
	ShowPlacesList	Gets or sets a value that controls whether to show or hide the list of pinned places that the user can choose from.
	Title	Gets or sets the dialog title.
	UsageIdentifier	Gets or sets a value that enables a calling application to associate a GUID with a dialog's persisted state.

Events

	Name	Description
	FileOk	Raised just before the dialog is about to return with a result.
	FileTypeChanged	Raised when the dialog is opened to notify the application of the initial chosen filetype.
	FolderChanged	Raised when the user navigates to a new folder.
	FolderChanging	Raised just before the user navigates to a new folder.
	Opening	Raised when the dialog is opening.
	SelectionChanged	Raised when the user changes the selection in the dialog's view.

See Also

© 2008 Microsoft Corporation. All rights reserved.