IVsUIShell.SaveDocDataToFile – metoda (VSSAVEFLAGS, Object, String, String, Int32)

Článek
08/05/2016

Pomocné metody editory, které implementují IVsPersistDocData rozhraní.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

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

grfSave
[v] Určuje volby pro uložení souboru.Další informace naleznete v tématu VSSAVEFLAGS.

pPersistFile
[v] Ukazatel IUnknown rozhraní souboru, ve kterém je uložena data dokumentu.

pszUntitledPath
[v] Cesta souboru, na který data doc pro jako- dosud neuložený dokument je uložen.

pbstrDocumentNew
[výstup] Nový název souboru dokumentu.

pfCanceled
[výstup] Nastavit na true Pokud uživatel přeruší uložit klepnutím Zrušit tlačítko.

Vrácená hodnota

Type: System.Int32

Pokud metoda uspěje, vrací S_OK.Pokud se nezdaří, vrátí kód chyby.

Poznámky

Podpis COM

Z vsshell.idl:

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

Tato metoda pomáhá implementovat Uložit jako dialogové okno.Data dokumentu objekt implementuje IPersistFileFormat uložení provést operaci.Tato metoda spravuje Uložit jako pomocí dialogového okna pole IPersistFileFormat ukazatel předaný jako vstup.

Standardní případ je, když dokument uloží všechny své informace o souboru.Obvykle uložit operace se nezdaří, pokud je problém s cíli (například disk je plný, zápis disk chráněný, není správné a podobně).Objekt není očekáván uložení selhání operace jiných důvodů než chybná volba Cíl.Tedy v případě, že se uložení nezdařilo, uživatel je informován o problému a k dialogové okno, kde můžete vybrat nové umístění (to znamená Uložit jako dialogové okno).Pro případ, kdy dokumentu uloží některé informace do samostatné úložiště a další informace o souboru Pokud selže uložit první samostatné úložiště informací, neexistuje bod v pokusu o jiný cíl pro část souboru.V této situaci dokument vrátí hodnotu OLE_E_PROMPTSAVECANCELED z Save.

Viz také

IVsUIShell – rozhraní
Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím