SaveFileDialog Класс

Определение

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

Сборка:: System.Windows.Forms.dll

Исходный код:: SaveFileDialog.cs

Исходный код:: SaveFileDialog.cs

Исходный код:: SaveFileDialog.cs

Исходный код:: SaveFileDialog.cs

Исходный код:: SaveFileDialog.cs

Важно!

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

Предложит пользователю выбрать расположение для сохранения файла. Этот класс не наследуется.

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)

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

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

Обратная связь

Были ли сведения на этой странице полезными?