Code:
/ DotNET / DotNET / 8.0 / untmp / WIN_WINDOWS / lh_tools_devdiv_wpf / Windows / wcp / Framework / Microsoft / Win32 / SaveFileDialog.cs / 1 / SaveFileDialog.cs
//---------------------------------------------------------------------------- // //// Copyright (C) Microsoft Corporation. All rights reserved. // // // Description: // SaveFileDialog is a sealed class derived from FileDialog that // implements File Save dialog-specific functions. It contains // the actual commdlg.dll call to GetSaveFileName() as well as // additional properties relevant only to save dialogs. // // // History: // [....] 7/7/2005 Created // //--------------------------------------------------------------------------- namespace Microsoft.Win32 { using MS.Internal.PresentationFramework; using MS.Win32; using System; using System.IO; using System.Security; using System.Security.Permissions; using System.Windows; ////// Represents a common dialog box that allows the user to specify options /// for saving a file. This class cannot be inherited. /// public sealed class SaveFileDialog : FileDialog { //--------------------------------------------------- // // Constructors // //--------------------------------------------------- #region Constructors // We add a constructor for our SaveFileDialog since we have // additional initialization tasks to do in addition to the // ones that FileDialog's constructor takes care of. ////// Initializes a new instance of the SaveFileDialog class. /// ////// Critical: Creates a dialog that can be used to open a file. /// PublicOk: It is okay to set the options to their defaults. The /// ctor does not show the dialog. /// [SecurityCritical] public SaveFileDialog() : base() { Initialize(); } #endregion Constructors //---------------------------------------------------- // // Public Methods // //--------------------------------------------------- #region Public Methods ////// Opens the file selected by the user with read-only permission. /// /// The filename used to open the file is the first element of the /// FileNamesInternal array. ////// Thrown if there are no filenames stored in the SaveFileDialog. /// ////// Callers must have UIPermission.AllWindows to call this API. /// ////// Critical: Opens files on the users machine. /// PublicOk: Demands UIPermission.AllWindows /// [SecurityCritical] public Stream OpenFile() { SecurityHelper.DemandUIWindowPermission(); // Extract the first filename from the FileNamesInternal list. // We can do this safely because FileNamesInternal never returns // null - if _fileNames is null, FileNamesInternal returns new string[0]; string filename = FileNamesInternal.Length > 0 ? FileNamesInternal[0] : null; // If we got an empty or null filename, throw an exception to // tell the user we don't have any files to open. if (String.IsNullOrEmpty(filename)) { throw new InvalidOperationException(SR.Get(SRID.FileNameMustNotBeNull)); } // Create a new FileStream from the file and return it. // in this case I deviate from the try finally protocol because this is the last statement and the permission is reverted // when the function exits (new FileIOPermission(FileIOPermissionAccess.Append | FileIOPermissionAccess.Read | FileIOPermissionAccess.Write, filename)).Assert();//BlessedAssert return new FileStream(filename, FileMode.Create, FileAccess.ReadWrite); } // // We override the FileDialog implementation to set a default // for OFN_FILEMUSTEXIST in addition to the other option flags // defined in FileDialog. ////// Resets all properties to their default values. /// ////// Callers must have UIPermission.AllWindows to call this API. /// ////// Critical: Calls base.Reset() and Initialize(), both of which are SecurityCritical /// PublicOk: Demands UIPermission.AllWindows /// [SecurityCritical] public override void Reset() { SecurityHelper.DemandUIWindowPermission(); // it is VERY important that the base.reset() call remain here // and be located at the top of this function. // Since most of the initialization for this class is actually // done in the FileDialog class, we must call that implementation // before we can finish with the Initialize() call specific to our // derived class. base.Reset(); Initialize(); } #endregion Public Methods //---------------------------------------------------- // // Public Properties // //---------------------------------------------------- #region Public Properties // OFN_CREATEPROMPT // If the user specifies a file that does not exist, this flag causes our code // to prompt the user for permission to create the file. If the user chooses // to create the file, the dialog box closes and the function returns the // specified name; otherwise, the dialog box remains open. // ////// Gets or sets a value indicating whether the dialog box prompts the user for /// permission to create a file if the user specifies a file that does not exist. /// ////// Callers must have UIPermission.AllWindows to call this API. /// ////// Critical: We do not want a Partially trusted application to have the ability /// to disable this prompt. /// PublicOk: Demands UIPermission.AllWindows /// public bool CreatePrompt { get { return GetOption(NativeMethods.OFN_CREATEPROMPT); } [SecurityCritical] set { SecurityHelper.DemandUIWindowPermission(); SetOption(NativeMethods.OFN_CREATEPROMPT, value); } } // OFN_OVERWRITEPROMPT // Causes our code to generate a message box if the selected file already // exists. The user must confirm whether to overwrite the file. // ////// Gets or sets a value indicating whether the Save As dialog box displays a /// warning if the user specifies a file name that already exists. /// ////// Callers must have UIPermission.AllWindows to call this API. /// ////// Critical: We do not want a Partially trusted application to have the ability /// to disable this prompt. /// PublicOk: Demands UIPermission.AllWindows /// public bool OverwritePrompt { get { return GetOption(NativeMethods.OFN_OVERWRITEPROMPT); } [SecurityCritical] set { SecurityHelper.DemandUIWindowPermission(); SetOption(NativeMethods.OFN_OVERWRITEPROMPT, value); } } #endregion Public Properties //--------------------------------------------------- // // Public Events // //---------------------------------------------------- //#region Public Events //#endregion Public Events //--------------------------------------------------- // // Protected Methods // //--------------------------------------------------- //#region Protected Methods //#endregion Protected Methods //--------------------------------------------------- // // Internal Methods // //---------------------------------------------------- #region Internal Methods ////// PromptUserIfAppropriate overrides a virtual function from FileDialog that show /// message boxes (like "Do you want to overwrite this file") necessary after /// the Save button is pressed in a file dialog. /// /// Return value is false if we showed a dialog box and true if we did not. /// (in other words, true if it's OK to continue with the save process and /// false if we need to return the user to the dialog to make another selection.) /// ////// We first call the base class implementation to deal with any messages handled there. /// Then, if OFN_OVERWRITEPROMPT (for a message box if the selected file already exists) /// or OFN_CREATEPROMPT (for a message box if a file is specified that does not exist) /// flags are set, we check to see if it is appropriate to show the dialog(s) in this /// method. If so, we then call PromptFileOverwrite or PromptFileCreate, respectively. /// ////// Critical: due to call to PromptFileNotFound, which /// displays a message box with focus restore. /// [SecurityCritical] internal override bool PromptUserIfAppropriate(string fileName) { // First, call the FileDialog implementation of PromptUserIfAppropriate // so any processing that happens there can occur. If it returns false, // we'll stop processing (to avoid showing more than one message box // before returning control to the user) and return false as well. if (!base.PromptUserIfAppropriate(fileName)) { return false; } // we use unrestricted file io because to extract the path from the file name // we need to assert path discovery except we do not know the path string pathInfo; bool fExist; (new FileIOPermission(PermissionState.Unrestricted)).Assert();//BlessedAssert try { pathInfo = Path.GetFullPath(fileName); fExist = File.Exists(Path.GetFullPath(fileName)); } finally { FileIOPermission.RevertAssert(); } // If the file does not exist, check if OFN_CREATEPROMPT is // set. If so, display the appropriate message box and act // on the user's choice. // Note that File.Exists requires a full path as a parameter. if (CreatePrompt && !fExist) { if (!PromptFileCreate(fileName)) { return false; } } // If the file already exists, check if OFN_OVERWRITEPROMPT is // set. If so, display the appropriate message box and act // on the user's choice. // Note that File.Exists requires a full path as a parameter. if (OverwritePrompt && fExist) { if (!PromptFileOverwrite(fileName)) { return false; } } // Since all dialog boxes we showed resulted in a positive outcome, // returning true allows the file dialog box to close. return true; } ////// Performs the actual call to display a file save dialog. /// ////// The call chain is ShowDialog > RunDialog > /// RunFileDialog (this function). In /// FileDialog.RunDialog, we created the OPENFILENAME /// structure - so all this function needs to do is /// call GetSaveFileName and process the result code. /// ////// Thrown if there is an invalid filename, if /// a subclass failure occurs or if the buffer length /// allocated to store the filenames occurs. /// ////// Critical: Makes a call to UnsafeNativeMethods.GetSaveFileName() /// [SecurityCritical] internal override bool RunFileDialog(NativeMethods.OPENFILENAME_I ofn) { bool result = false; // Make the actual call to GetSaveFileName. This function // blocks on GetSaveFileName until the entire dialog display // is completed - any interaction we have with the dialog // while it's open takes place through our HookProc. The // return value is a bool; true = success. result = UnsafeNativeMethods.GetSaveFileName(ofn); if (!result) // result was 0 (false), so an error occurred. { // Something may have gone wrong - check for error conditions // by calling CommDlgExtendedError to get the specific error. int errorCode = UnsafeNativeMethods.CommDlgExtendedError(); // Throw an appropriate exception if we know what happened: switch (errorCode) { // FNERR_INVALIDFILENAME is usually triggered when an invalid initial filename is specified case NativeMethods.FNERR_INVALIDFILENAME: throw new InvalidOperationException(SR.Get(SRID.FileDialogInvalidFileName, SafeFileName)); case NativeMethods.FNERR_SUBCLASSFAILURE: throw new InvalidOperationException(SR.Get(SRID.FileDialogSubClassFailure)); // note for FNERR_BUFFERTOOSMALL: // This error likely indicates a problem with our buffer size growing code; // take a look at that part of HookProc if customers report this error message is occurring. case NativeMethods.FNERR_BUFFERTOOSMALL: throw new InvalidOperationException(SR.Get(SRID.FileDialogBufferTooSmall)); /* * According to MSDN, the following errors can also occur, but we do not handle them as * they are very unlikely, and if they do occur, they indicate a catastrophic failure. * Most are related to features we do not wrap in our implementation. * * CDERR_DIALOGFAILURE * CDERR_FINDRESFAILURE * CDERR_INITIALIZATION * CDERR_LOADRESFAILURE * CDERR_LOADSTRFAILURE * CDERR_LOCKRESFAILURE * CDERR_MEMALLOCFAILURE * CDERR_MEMLOCKFAILURE * CDERR_NOHINSTANCE * CDERR_NOHOOK * CDERR_NOTEMPLATE * CDERR_STRUCTSIZE */ } } return result; } #endregion Internal Methods //--------------------------------------------------- // // Internal Properties // //---------------------------------------------------- //#region Internal Properties //#endregion Internal Properties //---------------------------------------------------- // // Internal Events // //--------------------------------------------------- //#region Internal Events //#endregion Internal Events //---------------------------------------------------- // // Private Methods // //--------------------------------------------------- #region Private Methods // Provides the actual implementation of initialization tasks. // Initialize() is called from both the constructor and the // public Reset() function to set default values for member // variables and for the options bitmask. // // We only perform SaveFileDialog() specific reset tasks here; // it's the calling code's responsibility to ensure that the // base is initialized first. ////// Critical: Calls SecurityCritical member (SetOption) /// [SecurityCritical] private void Initialize() { // OFN_OVERWRITEPROMPT // Causes the Save As dialog box to generate a message box if // the selected file already exists. The user must confirm // whether to overwrite the file. Default is true. SetOption(NativeMethods.OFN_OVERWRITEPROMPT, true); } ////// Prompts the user with a System.Windows.MessageBox /// when a file is about to be created. This method is /// invoked when the CreatePrompt property is true and the specified file /// does not exist. A return value of false prevents the dialog from closing. /// ////// Critical: Calls SecurityCritical MessageBoxWithFocusRestore. /// [SecurityCritical] private bool PromptFileCreate(string fileName) { return MessageBoxWithFocusRestore(SR.Get(SRID.FileDialogCreatePrompt, fileName), MessageBoxButton.YesNo, MessageBoxImage.Warning); } ////// Prompts the user when a file is about to be overwritten. This method is /// invoked when the "overwritePrompt" property is true and the specified /// file already exists. A return value of false prevents the dialog from /// closing. /// ////// Critical: Calls SecurityCritical MessageBoxWithFocusRestore. /// [SecurityCritical] private bool PromptFileOverwrite(string fileName) { return MessageBoxWithFocusRestore(SR.Get(SRID.FileDialogOverwritePrompt, fileName), MessageBoxButton.YesNo, MessageBoxImage.Warning); } #endregion Private Methods //--------------------------------------------------- // // Private Properties // //--------------------------------------------------- //#region Private Properties //#endregion Private Properties //---------------------------------------------------- // // Private Fields // //--------------------------------------------------- //#region Private Fields //#endregion Private Fields } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- ContextQuery.cs
- HwndKeyboardInputProvider.cs
- ProfileSettingsCollection.cs
- CookielessHelper.cs
- UnicastIPAddressInformationCollection.cs
- MyContact.cs
- XmlReturnWriter.cs
- TextServicesCompartment.cs
- OptimalTextSource.cs
- VoiceObjectToken.cs
- DynamicResourceExtension.cs
- CustomAttributeBuilder.cs
- EntitySqlException.cs
- relpropertyhelper.cs
- EnvironmentPermission.cs
- TableItemStyle.cs
- StylusPointCollection.cs
- AutomationEvent.cs
- SmtpSection.cs
- OletxEnlistment.cs
- UnsafeNativeMethods.cs
- OleDbPropertySetGuid.cs
- recordstatefactory.cs
- XmlNodeChangedEventArgs.cs
- datacache.cs
- MediaTimeline.cs
- XmlValidatingReader.cs
- ToolTip.cs
- input.cs
- DrawingState.cs
- DictionaryGlobals.cs
- GuidTagList.cs
- ExtensibleClassFactory.cs
- StringComparer.cs
- SynchronizingStream.cs
- BitmapFrame.cs
- CodeTypeConstructor.cs
- ToolStripSystemRenderer.cs
- _ShellExpression.cs
- ComboBoxRenderer.cs
- ShaderEffect.cs
- XsltContext.cs
- X509Certificate.cs
- Image.cs
- XmlSchemaSimpleContent.cs
- Lease.cs
- SqlServer2KCompatibilityAnnotation.cs
- ErrorWebPart.cs
- COM2PropertyBuilderUITypeEditor.cs
- AssociationTypeEmitter.cs
- RuntimeArgumentHandle.cs
- XPathAncestorIterator.cs
- SkinBuilder.cs
- SchemaType.cs
- NameSpaceEvent.cs
- Vector3D.cs
- TokenizerHelper.cs
- DESCryptoServiceProvider.cs
- BamlLocalizableResourceKey.cs
- ResourceSet.cs
- MapPathBasedVirtualPathProvider.cs
- ResourceManager.cs
- PrintDialog.cs
- RequestCacheValidator.cs
- InputEventArgs.cs
- ServiceOperationListItem.cs
- ControlAdapter.cs
- OleAutBinder.cs
- DesignSurfaceEvent.cs
- XmlILOptimizerVisitor.cs
- ParserHooks.cs
- AssemblyCollection.cs
- Faults.cs
- ButtonFieldBase.cs
- ScrollBarRenderer.cs
- ExpandableObjectConverter.cs
- MsmqChannelFactory.cs
- PictureBox.cs
- DataTemplateKey.cs
- DateTimeFormatInfoScanner.cs
- peersecurityelement.cs
- IsolatedStorageException.cs
- SignatureHelper.cs
- ProgressBar.cs
- WhiteSpaceTrimStringConverter.cs
- mactripleDES.cs
- BoundsDrawingContextWalker.cs
- SemaphoreSecurity.cs
- DBSqlParser.cs
- SQLBoolean.cs
- StringValueSerializer.cs
- ScrollEvent.cs
- ComplexPropertyEntry.cs
- AnnotationAdorner.cs
- EntityTypeEmitter.cs
- UnsettableComboBox.cs
- WebConvert.cs
- Validator.cs
- CacheMemory.cs
- SafeThreadHandle.cs