IVsUIShell.SaveDocDataToFile(VSSAVEFLAGS, Object, String, String, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Hilfsmethode, die Editoren verwenden, die die IVsPersistDocData-Schnittstelle implementieren.
public:
int SaveDocDataToFile(Microsoft::VisualStudio::Shell::Interop::VSSAVEFLAGS grfSave, System::Object ^ pPersistFile, System::String ^ pszUntitledPath, [Runtime::InteropServices::Out] System::String ^ % pbstrDocumentNew, [Runtime::InteropServices::Out] int % pfCanceled);
int SaveDocDataToFile(Microsoft::VisualStudio::Shell::Interop::VSSAVEFLAGS grfSave, winrt::Windows::Foundation::IInspectable const & pPersistFile, std::wstring const & pszUntitledPath, [Runtime::InteropServices::Out] std::wstring const & & pbstrDocumentNew, [Runtime::InteropServices::Out] int & pfCanceled);
public int SaveDocDataToFile (Microsoft.VisualStudio.Shell.Interop.VSSAVEFLAGS grfSave, object pPersistFile, string pszUntitledPath, out string pbstrDocumentNew, out int pfCanceled);
abstract member SaveDocDataToFile : Microsoft.VisualStudio.Shell.Interop.VSSAVEFLAGS * obj * string * string * int -> int
Public Function SaveDocDataToFile (grfSave As VSSAVEFLAGS, pPersistFile As Object, pszUntitledPath As String, ByRef pbstrDocumentNew As String, ByRef pfCanceled As Integer) As Integer
Parameter
- grfSave
- VSSAVEFLAGS
[in] Gibt Optionen zum Speichern der Datei an. Weitere Informationen finden Sie unter VSSAVEFLAGS.
- pPersistFile
- Object
[in] Zeiger auf die IUnknown-Schnittstelle der Datei, in der die Dokumentdaten gespeichert werden sollen.
- pszUntitledPath
- String
[in] Dateipfad, in dem die DOC-Daten für ein bisher nicht gespeichertes Dokument gespeichert werden sollen.
- pbstrDocumentNew
- String
[out] Neuer Name für die Dokumentdatei.
- pfCanceled
- Int32
vorgenommen Legen Sie auf fest, true Wenn der Benutzer den Speicher abbricht, indem Sie auf die Schaltfläche Abbrechen klicken.
Gibt zurück
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
COM-Signatur
Aus vsshell. idl:
HRESULT IVsUIShell::SaveDocDataToFile(
[in] VSSAVEFLAGS grfSave,
[in] IUnknown *pPersistFile,
[in] LPCOLESTR pszUntitledPath,
[out] BSTR *pbstrDocumentNew,
[out] BOOL *pfCanceled
);
Diese Methode hilft bei der Implementierung des Dialog Felds " Speichern unter". Das Dokument Datenobjekt implementiert IPersistFileFormat , um den Speichervorgang auszuführen. Mit dieser Methode wird das Dialogfeld Speichern unter mit dem IPersistFileFormat als Eingabe eingegebenen Zeiger verwaltet.
Der Standardfall ist, wenn in einem Dokument alle seine Informationen in einer Datei gespeichert werden. Normalerweise schlägt ein Speichervorgang fehl, wenn ein Problem mit dem Ziel vorliegt (z. b. Datenträger voll, Schreib geschützter Datenträger, nicht korrekt usw.). Ein Objekt wird nicht erwartet, dass ein Speichervorgang aus anderen Gründen fehlschlägt als bei einer ungültigen Zielauswahl. Wenn beim Speichern ein Fehler aufgetreten ist, wird der Benutzer über das Problem informiert und zum Dialogfeld geleitet, in dem ein neues Ziel ausgewählt werden kann (das heißt, das Dialogfeld Speichern unter). Wenn in einem Dokument einige Informationen in einem separaten Speicher gespeichert werden und andere Informationen in der Datei gespeichert werden, gibt es keinen Punkt, an dem ein anderes Ziel für den Datei Teil ausprobiert werden kann, wenn das Speichern der ersten Informationen im separaten Speicher fehlschlägt. In dieser Situation gibt das Dokument den Wert OLE_E_PROMPTSAVECANCELED von zurück Save .