Método IVsUIShell.SaveDocDataToFile (VSSAVEFLAGS, Object, String, String, Int32)

Artigo
08/03/2016

Publicado: abril de 2016

Método auxiliar, usado pelos editores que implementam o IVsPersistDocData interface.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

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

Parâmetros

grfSave
[in] Especifica as opções de salvamento do arquivo.Para obter mais informações, consulte VSSAVEFLAGS.

pPersistFile
[in] Ponteiro para o IUnknown interface do arquivo no qual os dados doc estão a ser salvo.

pszUntitledPath
[in] Caminho de arquivo para o qual os dados que doc- ainda que o documento não salvo está a ser salvo.

pbstrDocumentNew
[out] Novo nome de arquivo do documento.

pfCanceled
[out] Definido como true se o usuário salvar, clicando no Cancelar botão.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell.idl:

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

Este método ajuda a implementar o Salvar como caixa de diálogo.O documento objeto de dados implementa IPersistFileFormat para executar o salvamento operação.Esse método gerencia o Salvar como caixa de diálogo usando o IPersistFileFormat ponteiro é passado como entrada.

Caso o padrão é quando um documento salva todas as suas informações em um arquivo.Normalmente, um salvamento operação falhar se houver um problema com o destino (por exemplo, disco cheio, gravação de disco protegida, não está correta e assim por diante).Um objeto não é se espera um salvamento operação por outros motivos que uma escolha incorreta do destino.Assim, se o salvamento falhou, o usuário é informado do problema e a caixa de diálogo em que um novo destino pode ser escolhido (ou seja, o Salvar como caixa de diálogo).Para o caso em que um documento salva a algumas informações para um armazenamento separado e outras informações do arquivo, se não conseguir salvar as informações primeiro para o armazenamento separado, não há nenhum ponto na tentativa de um destino diferente para a parte do arquivo.Nessa situação, o documento retorna um valor de OLE_E_PROMPTSAVECANCELED de Save.

Consulte também

Interface IVsUIShell
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via