IVsQueryEditQuerySave2.DeclareUnreloadableFile(String, UInt32, VSQEQS_FILE_ATTRIBUTE_DATA[]) Méthode

Définition

Indique qu'un fichier ne sera pas rechargé s'il change sur le disque.

public:
 int DeclareUnreloadableFile(System::String ^ pszMkDocument, System::UInt32 rgf, cli::array <Microsoft::VisualStudio::Shell::Interop::VSQEQS_FILE_ATTRIBUTE_DATA> ^ pFileInfo);
int DeclareUnreloadableFile(std::wstring const & pszMkDocument, unsigned int rgf, std::Array <Microsoft::VisualStudio::Shell::Interop::VSQEQS_FILE_ATTRIBUTE_DATA> const & pFileInfo);
public int DeclareUnreloadableFile (string pszMkDocument, uint rgf, Microsoft.VisualStudio.Shell.Interop.VSQEQS_FILE_ATTRIBUTE_DATA[] pFileInfo);
abstract member DeclareUnreloadableFile : string * uint32 * Microsoft.VisualStudio.Shell.Interop.VSQEQS_FILE_ATTRIBUTE_DATA[] -> int
Public Function DeclareUnreloadableFile (pszMkDocument As String, rgf As UInteger, pFileInfo As VSQEQS_FILE_ATTRIBUTE_DATA()) As Integer

Paramètres

pszMkDocument
String

[in] Chemin d'accès complet au fichier sur le disque.

rgf
UInt32

[in] Indicateurs dont les valeurs des attributs de fichier sont issues de l'énumération tagVSQEQSFlags. Valeur par défaut = 0.

pFileInfo
VSQEQS_FILE_ATTRIBUTE_DATA[]

[in] Peut être NULL. Ce paramètre est ignoré si rgf est égal à 0. Les valeurs proviennent de la structure VSQEQS_FILE_ATTRIBUTE_DATA.

Retours

Int32

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Signature COM

À partir de IVsQueryEditQuerySave2. idl

HRESULT DeclareUnreloadableFile(  
   [in] LPCOLESTR pszMkDocument,  
   [in] VSQEQSFlags rgf,  
   [in] const VSQEQS_FILE_ATTRIBUTE_DATA* pFileInfo  
);  

L'utilisation de cette méthode n'est pas recommandée. Les éditeurs doivent prendre en charge le rechargement.

Cette méthode est appelée pour s’assurer que QueryEditFiles les QuerySaveFile méthodes, et QuerySaveFiles savent qu’un fichier n’est pas rechargeable. Elle doit être appelée dans les circonstances suivantes :

  • Le projet, la solution ou l’éditeur peuvent ainsi s’assurer que le service sait que le fichier ne peut pas être rechargé,

    -ou-

  • Lorsque IsDocDataReloadable spécifie que le fichier ne peut pas être rechargé en retournant false .

Si le fichier rechargeable est en cours de modification, vous ne pouvez pas récupérer la dernière version de celui-ci. Il est possible que les fichiers passent d’un rechargement à rechargeable pendant la durée de vie d’un éditeur.

S’applique à