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

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

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)

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

Поделиться через