Code:
/ DotNET / DotNET / 8.0 / untmp / WIN_WINDOWS / lh_tools_devdiv_wpf / Windows / wcp / Framework / Microsoft / Win32 / OpenFileDialog.cs / 1 / OpenFileDialog.cs
//---------------------------------------------------------------------------- // //// Copyright (C) Microsoft Corporation. All rights reserved. // // // Description: // OpenFileDialog is a sealed class derived from FileDialog that // implements File Open dialog-specific functions. It contains // the actual commdlg.dll call to GetOpenFileName() as well as // additional properties relevant only to save dialogs. // // // History: // [....] 7/7/2005 Created // //--------------------------------------------------------------------------- namespace Microsoft.Win32 { using System; using System.IO; using System.Security; using System.Security.Permissions; using System.Windows; using MS.Internal.PresentationFramework; using MS.Win32; ////// Represents a common dialog box that allows the user to open one or more file(s). /// This class cannot be inherited. /// public sealed class OpenFileDialog : FileDialog { //--------------------------------------------------- // // Constructors // //--------------------------------------------------- #region Constructors // We add a constructor for our OpenFileDialog 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 OpenFileDialog 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 OpenFileDialog() : base() { Initialize(); } #endregion Constructors //---------------------------------------------------- // // Public Methods // //--------------------------------------------------- #region Public Methods ////// Opens the file selected by the user with read-only permission, /// whether or not the Read Only checkbox is checked in the dialog. /// /// The filename used to open the file is the first element of the /// FileNamesInternal array. ////// Thrown if there are no filenames stored in the OpenFileDialog. /// ////// Callers must have FileDialogPermission(FileDialogPermissionAccess.Open) to call this API. /// ////// Critical: Creates a FileStream on a file, and asserts FileIOPermission in /// order to do so. /// PublicOk: Demands FileDialogPermission (FileDialogPermission.Read), /// doesn't allow user code to specify the file to be opened, /// and opens the file with read-only FileAccess. /// [SecurityCritical] public Stream OpenFile() { SecurityHelper.DemandFileDialogOpenPermission(); // 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[0]; // 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)); } FileStream fileStream = null; (new FileIOPermission(FileIOPermissionAccess.Read, filename)).Assert(); try { fileStream = new FileStream(filename, FileMode.Open, FileAccess.Read, FileShare.Read); } finally { CodeAccessPermission.RevertAssert(); } // Create a new FileStream from the file and return it. return fileStream; } ////// Opens the files selected by the user with read-only permission and /// returns an array of streams, one per file. /// ////// Thrown if there are no filenames stored in the OpenFileDialog /// ////// Callers must have FileDialogPermission(FileDialogPermissionAccess.Open) to call this API. /// ////// Critical: Creates a FileStream on a file, and asserts FileIOPermission in /// order to do so. /// PublicOk: Demands FileDialogPermission (FileDialogPermission.Read), and only /// opens the files for read access. /// [SecurityCritical] public Stream[] OpenFiles() { SecurityHelper.DemandFileDialogOpenPermission(); // Cache FileNamesInternal to avoid perf issues as per // FxCop #CA1817 String[] cachedFileNames = FileNamesInternal; // Create an array to hold the streams that is exactly // as long as FileNamesInternal. Stream[] streams = new Stream[cachedFileNames.Length]; // For each element in FileNamesInternal: for (int i = 0; i < cachedFileNames.Length; i++) { // Verify that the filename at this index in the FileNamesInternal // array is not null or empty. string filename = cachedFileNames[i]; if (String.IsNullOrEmpty(filename)) { throw new InvalidOperationException(SR.Get(SRID.FileNameMustNotBeNull)); } FileStream fileStream = null; (new FileIOPermission(FileIOPermissionAccess.Read, filename)).Assert(); try { fileStream = new FileStream(filename, FileMode.Open, FileAccess.Read, FileShare.Read); } finally { CodeAccessPermission.RevertAssert(); } // Open the file and add it to the list of streams. streams[i] = fileStream; } // Return the array of open streams. return streams; } // 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 FileIOPermission(PermissionState.Unrestricted) to call this API. /// ////// Critical: Sets Dialog options, which are critical for set. /// PublicOk: Demands FileIOPermission (PermissionState.Unrestricted) /// [SecurityCritical] public override void Reset() { SecurityHelper.DemandUnrestrictedFileIOPermission(); // 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_ALLOWMULTISELECT // Specifies that the File Name list box allows multiple // selections. // ////// Gets or sets an option flag indicating whether the /// dialog box allows multiple files to be selected. /// ////// Critical: Dialog options are critical for set. /// PublicOk: Allowing MultiSelect is a safe operation /// public bool Multiselect { get { return GetOption(NativeMethods.OFN_ALLOWMULTISELECT); } [SecurityCritical] set { SetOption(NativeMethods.OFN_ALLOWMULTISELECT, value); } } // OFN_READONLY // Causes the Read Only check box to be selected initially // when the dialog box is created. This flag indicates the // state of the Read Only check box when the dialog box is // closed. // ////// Gets or sets a value indicating whether the read-only /// check box is selected. /// ////// Critical: Dialog options are critical for set. (Only critical for set /// because setting options affects the behavior of the FileDialog) /// PublicOk: ReadOnlyChecked is not a security critical option /// public bool ReadOnlyChecked { get { return GetOption(NativeMethods.OFN_READONLY); } [SecurityCritical] set { SetOption(NativeMethods.OFN_READONLY, value); } } // // Our property is the inverse of the Win32 flag, // OFN_HIDEREADONLY. // // OFN_HIDEREADONLY // Hides the Read Only check box. // ////// Gets or sets a value indicating whether the dialog /// contains a read-only check box. /// ////// Critical: Dialog options are critical for set. /// PublicOk: ShowReadOnly is not a security critical option /// public bool ShowReadOnly { get { // OFN_HIDEREADONLY is the inverse of our property, // so negate the results of GetOption... return !GetOption(NativeMethods.OFN_HIDEREADONLY); } [SecurityCritical] set { // ... and SetOption. SetOption(NativeMethods.OFN_HIDEREADONLY, !value); } } #endregion Public Properties //--------------------------------------------------- // // Public Events // //---------------------------------------------------- //#region Public Events //#endregion Public Events //--------------------------------------------------- // // Protected Methods // //--------------------------------------------------- #region Protected Methods ////// Demands permissions appropriate to the dialog to be shown. /// protected override void CheckPermissionsToShowDialog() { SecurityHelper.DemandFileDialogOpenPermission(); } #endregion Protected Methods //--------------------------------------------------- // // Internal Methods // //---------------------------------------------------- #region Internal Methods ////// Performs the actual call to display a file open dialog. /// ////// Thrown if there is an invalid filename, if /// a subclass failure occurs or if the buffer length /// allocated to store the filenames occurs. /// ////// 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 GetOpenFileName and process the result code. /// ////// Critical: Call to UnsafeNativeMethods.GetOpenFileName() and /// UnsafeNativeMethods.CommDlgExtendedError() /// [SecurityCritical] internal override bool RunFileDialog(NativeMethods.OPENFILENAME_I ofn) { bool result = false; // Make the actual call to GetOpenFileName. This function // blocks on GetOpenFileName 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.GetOpenFileName(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_NOHINSTANCE * CDERR_INITIALIZATION * CDERR_NOHOOK * CDERR_LOCKRESFAILURE * CDERR_NOTEMPLATE * CDERR_LOADRESFAILURE * CDERR_STRUCTSIZE * CDERR_LOADSTRFAILURE * CDERR_MEMALLOCFAILURE * CDERR_MEMLOCKFAILURE */ } } 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 OpenFileDialog() specific reset tasks here; // it's the calling code's responsibility to ensure that the // base is initialized first. // ////// Critical: Sets Dialog options, which are critical for set. /// [SecurityCritical] private void Initialize() { // OFN_FILEMUSTEXIST // Specifies that the user can type only names of existing files // in the File Name entry field. If this flag is specified and // the user enters an invalid name, we display a warning in a // message box. Implies OFN_PATHMUSTEXIST. SetOption(NativeMethods.OFN_FILEMUSTEXIST, true); } #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
- RemoteCryptoSignHashRequest.cs
- SqlDataReaderSmi.cs
- CorrelationTokenTypeConvertor.cs
- HtmlValidatorAdapter.cs
- SafeProcessHandle.cs
- ContextMenuStripActionList.cs
- ServiceManagerHandle.cs
- IdnElement.cs
- DataServiceContext.cs
- FieldDescriptor.cs
- AnchorEditor.cs
- TabItem.cs
- DataControlFieldCell.cs
- HttpCookiesSection.cs
- TextRunCache.cs
- SocketPermission.cs
- Int32KeyFrameCollection.cs
- CommonDialog.cs
- TreeNodeBinding.cs
- StrokeFIndices.cs
- ContainerAction.cs
- KerberosSecurityTokenAuthenticator.cs
- OleDbParameter.cs
- Size.cs
- ISFClipboardData.cs
- SamlAction.cs
- MemberPath.cs
- HTTPNotFoundHandler.cs
- UserControlBuildProvider.cs
- DataGridViewComboBoxColumn.cs
- CodeMemberProperty.cs
- GcHandle.cs
- XmlText.cs
- RC2.cs
- MdiWindowListItemConverter.cs
- SqlDuplicator.cs
- CatalogPartCollection.cs
- HtmlMobileTextWriter.cs
- QueryContinueDragEvent.cs
- CultureTableRecord.cs
- RepeaterItemEventArgs.cs
- ResXResourceSet.cs
- InputManager.cs
- TabControl.cs
- CodeObjectCreateExpression.cs
- UpdatePanelTrigger.cs
- AttachedPropertyMethodSelector.cs
- ResourceExpressionEditorSheet.cs
- EnterpriseServicesHelper.cs
- XmlSerializerOperationGenerator.cs
- HwndProxyElementProvider.cs
- SystemDiagnosticsSection.cs
- SoapTypeAttribute.cs
- ColorMap.cs
- documentsequencetextpointer.cs
- FastEncoderWindow.cs
- IndexedEnumerable.cs
- XPathNodeList.cs
- TagPrefixAttribute.cs
- Lazy.cs
- FileDialogPermission.cs
- TypeGeneratedEventArgs.cs
- FileDialog_Vista_Interop.cs
- BlobPersonalizationState.cs
- NonVisualControlAttribute.cs
- MetadataArtifactLoaderXmlReaderWrapper.cs
- TypeBuilderInstantiation.cs
- Random.cs
- ClientTarget.cs
- WebPartCatalogAddVerb.cs
- XmlStringTable.cs
- SerializerWriterEventHandlers.cs
- AnnotationResource.cs
- httpapplicationstate.cs
- CatalogZoneDesigner.cs
- TransportOutputChannel.cs
- RepeaterItemEventArgs.cs
- SqlCachedBuffer.cs
- ValidationErrorCollection.cs
- PseudoWebRequest.cs
- DefaultValueAttribute.cs
- StyleBamlTreeBuilder.cs
- BinaryHeap.cs
- UnicastIPAddressInformationCollection.cs
- SerializationFieldInfo.cs
- ValidationError.cs
- sqlmetadatafactory.cs
- SiteMapProvider.cs
- DoubleConverter.cs
- WebPartRestoreVerb.cs
- EntityDataSourceView.cs
- TypeBuilder.cs
- Size3DConverter.cs
- ClientSettingsProvider.cs
- DispatchWrapper.cs
- SessionStateItemCollection.cs
- DictionaryBase.cs
- HttpContext.cs
- RangeEnumerable.cs
- Stack.cs