SaveFileDialog Класс

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Запрашивает у пользователя местоположение для сохранения файла. Этот класс не наследуется.

public ref class SaveFileDialog sealed : System::Windows::Forms::FileDialog
public sealed class SaveFileDialog : System.Windows.Forms.FileDialog
type SaveFileDialog = class
    inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
Наследование
Object
MarshalByRefObject
Component
CommonDialog
FileDialog
SaveFileDialog

Примеры

В следующем примере кода показано создание SaveFileDialog, задание членов, вызов диалогового ShowDialog окна с помощью метода и сохранение текущего файла. В этом примере требуется форма с размещенной кнопкой.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Stream^ myStream;
      SaveFileDialog^ saveFileDialog1 = gcnew SaveFileDialog;
      saveFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
      saveFileDialog1->FilterIndex = 2;
      saveFileDialog1->RestoreDirectory = true;
      if ( saveFileDialog1->ShowDialog() == ::DialogResult::OK )
      {
         if ( (myStream = saveFileDialog1->OpenFile()) != nullptr )
         {
            
            // Code to write the stream goes here.
            myStream->Close();
         }
      }
   }

private void button1_Click(object sender, System.EventArgs e)
 {
     Stream myStream ;
     SaveFileDialog saveFileDialog1 = new SaveFileDialog();
 
     saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"  ;
     saveFileDialog1.FilterIndex = 2 ;
     saveFileDialog1.RestoreDirectory = true ;
 
     if(saveFileDialog1.ShowDialog() == DialogResult.OK)
     {
         if((myStream = saveFileDialog1.OpenFile()) != null)
         {
             // Code to write the stream goes here.
             myStream.Close();
         }
     }
 }

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    Dim myStream As Stream
    Dim saveFileDialog1 As New SaveFileDialog()
    
    saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
    saveFileDialog1.FilterIndex = 2
    saveFileDialog1.RestoreDirectory = True
    
    If saveFileDialog1.ShowDialog() = DialogResult.OK Then
        myStream = saveFileDialog1.OpenFile()
        If (myStream IsNot Nothing) Then
            ' Code to write the stream goes here.
            myStream.Close()
        End If
    End If
End Sub

Комментарии

Этот класс может открыть и перезаписать существующий файл или создать новый.

Большая часть функциональных возможностей этого класса находится в FileDialog классе .

Конструкторы

SaveFileDialog()

Инициализирует новый экземпляр этого класса.

Свойства

AddExtension

Возвращает или задает значение, определяющее, добавляет ли автоматически диалоговое окно расширение к имени файла, если пользователь опускает данное расширение.

(Унаследовано от FileDialog)
AddToRecent

Возвращает или задает значение, указывающее, добавляет ли диалоговое окно открываемый или сохраненный файл в список последних.

(Унаследовано от FileDialog)
AutoUpgradeEnabled

Возвращает или задает значение, указывающее, должен ли этот FileDialog экземпляр автоматически обновлять внешний вид и поведение при работе в Windows Vista.

(Унаследовано от FileDialog)
CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.

(Унаследовано от Component)
CheckFileExists

Возвращает или задает значение, указывающее, отображается ли в диалоговом окне предупреждение, если пользователь указывает несуществующее имя файла.

(Унаследовано от FileDialog)
CheckPathExists

Возвращает или задает значение, указывающее, отображает ли диалоговое окно предупреждение, если пользователь указывает несуществующий путь.

(Унаследовано от FileDialog)
CheckWriteAccess

Возвращает или задает значение, указывающее, проверяет ли диалоговое окно успешное создание указанного файла. Если этот флаг не установлен, вызывающее приложение должно обрабатывать ошибки, такие как отказ в доступе, обнаруженные при создании элемента.
ClientGuid

Получает или задает GUID, связываемый с этим состоянием диалога. Как правило, состояние, такое как последняя посещенная папка, а также расположение и размер диалогового окна, сохраняется с учетом имени исполняемого файла. При указании GUID приложение может иметь разные сохраняемые состояния для разных версий диалогового окна в том же приложении (например, диалоговое окно импорта и диалоговое окно открытия).

Эта функция недоступна, если приложение не использует стили оформления или если для AutoUpgradeEnabled задано значение false.

(Унаследовано от FileDialog)
Container

Возвращает объект IContainer, который содержит коллекцию Component.

(Унаследовано от Component)
CreatePrompt

Возвращает или задает значение, показывающее, будет ли диалоговое окно запрашивать у пользователя разрешение на создание файла, если указанный файл не существует.
CustomPlaces

Получает коллекцию пользовательских размещений для этого экземпляра FileDialog.

(Унаследовано от FileDialog)
DefaultExt

Возвращает или задает расширение имени файла по умолчанию.

(Унаследовано от FileDialog)
DereferenceLinks

Возвращает или задает значение, указывающее, возвращает ли диалоговое окно расположение файла, представленного ярлыком, или возвращает расположение самого ярлыка (.lnk).

(Унаследовано от FileDialog)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.

(Унаследовано от Component)
ExpandedMode

Возвращает или задает значение, указывающее, открывается ли диалоговое окно в развернутом режиме.
FileName

Возвращает или задает строку, содержащую имя файла, выбранного в диалоговом окне.

(Унаследовано от FileDialog)
FileNames

Возвращает имена всех выбранных файлов в диалоговом окне.

(Унаследовано от FileDialog)
Filter

Возвращает или задает текущую строку фильтра имен файлов, которая определяет варианты, доступные в поле диалогового окна "Сохранить как файл типа" или "Файлы типа".

(Унаследовано от FileDialog)
FilterIndex

Возвращает или задает индекс фильтра, выбранного в настоящий момент в диалоговом окне файла.

(Унаследовано от FileDialog)
InitialDirectory

Возвращает или задает начальную папку, отображенную диалоговым окном файла.

(Унаследовано от FileDialog)
Instance

Возвращает дескриптор экземпляра обработчика Win32 для приложения.

(Унаследовано от FileDialog)
OkRequiresInteraction

Возвращает или задает значение, указывающее, отключена ли кнопка ОК диалогового окна, пока пользователь не перейдет по представлению или не изменит имя файла (если применимо).

(Унаследовано от FileDialog)
Options

Получает значения для инициализации класса FileDialog.

(Унаследовано от FileDialog)
OverwritePrompt

Возвращает или задает значение, показывающее, будет ли диалоговое окно Save As выводить предупреждение, если файл с указанным именем уже существует.
RestoreDirectory

Получает или задает значение, указывающее, восстанавливает ли диалоговое окно ранее выбранный каталог в качестве текущего каталога перед закрытием.

(Унаследовано от FileDialog)
ShowHelp

Возвращает или задает значение, определяющее, отображается ли кнопка Справка в диалоговом окне работы с файлами.

(Унаследовано от FileDialog)
ShowHiddenFiles

Возвращает или задает значение, указывающее, отображается ли в диалоговом окне скрытые и системные файлы.

(Унаследовано от FileDialog)
ShowPinnedPlaces

Возвращает или задает значение, указывающее, отображаются ли элементы, отображаемые по умолчанию в области навигации представления.

(Унаследовано от FileDialog)
Site

Получает или задает ISite объекта Component.

(Унаследовано от Component)
SupportMultiDottedExtensions

Возвращает или задает значение, определяющее, поддерживает ли диалоговое окно отображение и сохранение файлов, которые содержат несколько расширений имени.

(Унаследовано от FileDialog)
Tag

Получает или задает объект, содержащий данные элемента управления.

(Унаследовано от CommonDialog)
Title

Возвращает или задает заголовок диалогового окна файла.

(Унаследовано от FileDialog)
ValidateNames

Возвращает или задает значение, указывающее, принимает ли диалоговое окно только допустимые имена файлов Win32.

(Унаследовано от FileDialog)

Методы

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.

(Унаследовано от Component)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetLifetimeService()
Устаревшие..

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Определяет процедуру обработки общего диалогового окна, переопределенную, чтобы добавить специальные функции в диалоговое окно файла.

(Унаследовано от FileDialog)
InitializeLifetimeService()
Устаревшие..

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.

(Унаследовано от MarshalByRefObject)
OnFileOk(CancelEventArgs)

Вызывает событие FileOk.

(Унаследовано от FileDialog)
OnHelpRequest(EventArgs)

Вызывает событие HelpRequest.

(Унаследовано от CommonDialog)
OpenFile()

Открывает выбранный пользователем файл с разрешением на чтение и запись.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Определяет процедуру окна-владельца, которая переопределяется, чтобы добавить специальные функции для общего диалогового окна.

(Унаследовано от CommonDialog)
Reset()

Возвращает всем параметрам диалогового окна значения по умолчанию.
RunDialog(IntPtr)

Указывает общее диалоговое окно.

(Унаследовано от FileDialog)
ShowDialog()

Запускает общее диалоговое окно с заданным по умолчанию владельцем.

(Унаследовано от CommonDialog)
ShowDialog(IWin32Window)

Запускает общее диалоговое окно с указанным владельцем.

(Унаследовано от CommonDialog)
ToString()

Представляет строковую версию этого объекта.

(Унаследовано от FileDialog)

События

Disposed

Возникает при удалении компонента путем вызова метода Dispose().

(Унаследовано от Component)
FileOk

Происходит при нажатии пользователем кнопки Открыть или Сохранить в диалоговом окне файла.

(Унаследовано от FileDialog)
HelpRequest

Происходит при нажатии пользователем кнопки справки в общем диалоговом окне.

(Унаследовано от CommonDialog)

Применяется к

См. также раздел