Udostępnij za pośrednictwem

Metoda IVsUIShell.SaveDocDataToFile — (VSSAVEFLAGS, Object, String, String, Int32)

  • Artykuł

 

Metoda pomocnika używane przez edytory, które implementują IVsPersistDocData interfejsu.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int SaveDocDataToFile(
    VSSAVEFLAGS grfSave,
    object pPersistFile,
    string pszUntitledPath,
    out string pbstrDocumentNew,
    out int pfCanceled
)

int SaveDocDataToFile(
    VSSAVEFLAGS grfSave,
    Object^ pPersistFile,
    String^ pszUntitledPath,
    [OutAttribute] String^% pbstrDocumentNew,
    [OutAttribute] int% pfCanceled
)

abstract SaveDocDataToFile : 
        grfSave:VSSAVEFLAGS *
        pPersistFile:Object *
        pszUntitledPath:string *
        pbstrDocumentNew:string byref *
        pfCanceled:int byref -> int

Function SaveDocDataToFile (
    grfSave As VSSAVEFLAGS,
    pPersistFile As Object,
    pszUntitledPath As String,
    <OutAttribute> ByRef pbstrDocumentNew As String,
    <OutAttribute> ByRef pfCanceled As Integer
) As Integer

Parametry

  • pPersistFile
    Type: System.Object

    [in] Wskaźnik do IUnknown interfejs pliku, w którym ma zostać zapisany danych dokumentu.

  • pszUntitledPath
    Type: System.String

    [in] Ścieżka pliku, do którego dane jako doc- jeszcze niezapisane dokument ma zostać zapisany.

  • pbstrDocumentNew
    Type: System.String

    [out] Nowa nazwa pliku dokumentu.

  • pfCanceled
    Type: System.Int32

    [out] Wartość true Jeśli użytkownik przerywa zapisywania klikając Anuluj przycisku.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell.idl:

HRESULT IVsUIShell::SaveDocDataToFile(
   [in] VSSAVEFLAGS grfSave,
   [in] IUnknown *pPersistFile,
   [in] LPCOLESTR pszUntitledPath,
   [out] BSTR *pbstrDocumentNew,
   [out] BOOL *pfCanceled
);

Ta metoda ułatwia zaimplementować Zapisz jako okno dialogowe. Implementuje obiekt danych dokumentu IPersistFileFormat Zapisz wykonać operację. Ta metoda zarządza Zapisz jako przy użyciu okno dialogowe IPersistFileFormat Wskaźnik przekazany jako dane wejściowe.

Standardowa sprawa jest podczas zapisywania dokumentu wszystkie jego informacje w pliku. Zazwyczaj zapisywania operacja zakończy się niepowodzeniem, jeśli występuje problem z serwerem docelowym (na przykład dysk jest zapełniony, zapisu na dysku chronionym, nie będą prawidłowe i tak dalej). Nie Oczekiwano obiektu niepowodzenie zapisywania operacji innego powodu niż nieprawidłowy wybór lokalizacji docelowej. W związku z tym, jeśli do zapisania, użytkownik zostanie poinformowany o problemie i zostanie przeprowadzony do okna dialogowego, w którym można wybrać nową lokalizację docelową (czyli Zapisz jako okno dialogowe). W przypadku, gdy dokument zapisuje niektóre informacje do osobnego magazynu i innych informacji do pliku Jeśli Zapisz pierwszej informacji do osobnego magazynu nie powiedzie się, nie ma żadnych punktu wypróbować inną lokalizację docelową dla części pliku. W takiej sytuacji dokument zwraca wartość OLE_E_PROMPTSAVECANCELED z Save.

Zobacz też

Interfejs IVsUIShell
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku