IVsQueryEditQuerySave2.DeclareReloadableFile(String, UInt32, VSQEQS_FILE_ATTRIBUTE_DATA[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Indique qu'un fichier sera rechargé s'il change sur le disque.
public:
int DeclareReloadableFile(System::String ^ pszMkDocument, System::UInt32 rgf, cli::array <Microsoft::VisualStudio::Shell::Interop::VSQEQS_FILE_ATTRIBUTE_DATA> ^ pFileInfo);
int DeclareReloadableFile(std::wstring const & pszMkDocument, unsigned int rgf, std::Array <Microsoft::VisualStudio::Shell::Interop::VSQEQS_FILE_ATTRIBUTE_DATA> const & pFileInfo);
public int DeclareReloadableFile (string pszMkDocument, uint rgf, Microsoft.VisualStudio.Shell.Interop.VSQEQS_FILE_ATTRIBUTE_DATA[] pFileInfo);
abstract member DeclareReloadableFile : string * uint32 * Microsoft.VisualStudio.Shell.Interop.VSQEQS_FILE_ATTRIBUTE_DATA[] -> int
Public Function DeclareReloadableFile (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. La valeur par défaut est zéro.
- 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
Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.
Remarques
Utilisé uniquement dans des cas spéciaux.
Signature COM
À partir de IVsQueryEditQuerySave2. idl
HRESULT DeclareReloadableFile(
[in] LPCOLESTR pszMkDocument,
[in] VSQEQSFlags rgf,
[in] const VSQEQS_FILE_ATTRIBUTE_DATA* pFileInfo
);
L’environnement appelle automatiquement cette méthode de service pour le compte d’un projet pour son nœud racine, et pour les fichiers solution. sln. Elle est également appelée dans les circonstances suivantes :
Le projet ou l’éditeur peut donc s’assurer que le service sait que le fichier est rechargeable.
-ou-
Quand IsDocDataReloadable le spécifie en retournant
true. (Il s’agit de la casse recommandée.)
Si aucune autre information n’est disponible, les éléments passés à QueryEditFiles , QuerySaveFile , QuerySaveFiles ou OnAfterAttributeChange ( RDTA_DocDataIsDirty ) sont considérés comme rechargeables uniquement s’ils sont déclarés. Un élément est également rechargeable si l’objet de document prend en charge IVsPersistDocData ou si la hiérarchie parente prend en charge IVsPersistHierarchyItem2 . Il est possible que les fichiers passent d’un rechargement à rechargeable pendant la durée de vie d’un éditeur.
Notes
Par défaut, un fichier est supposé ne pas être rechargé en l’absence de IVsPersistDocData ou de IVsPersistHierarchyItem2 .