IVsProjectAsyncOpen.OpenItemAsync(UInt32, Guid, Boolean, Object) 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.
Ouvre de façon asynchrone un élément dans le projet.
public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenItemAsync (uint itemId, Guid logicalView, bool shouldGetDocDataFromRdt, object? docData);
abstract member OpenItemAsync : uint32 * Guid * bool * obj -> Microsoft.VisualStudio.Shell.Interop.IVsTask
Public Function OpenItemAsync (itemId As UInteger, logicalView As Guid, shouldGetDocDataFromRdt As Boolean, docData As Object) As IVsTask
Paramètres
- itemId
- UInt32
Identificateur de l’élément à ouvrir.
Doit être VSITEMID_ROOT
ou tout autre identificateur d'élément valide.
Consultez l'énumération VSITEMID
.
- logicalView
- Guid
Identificateur unique de l'affichage logique.
Si ce n’est pas GUID_NULL
le cas, indique un type spécifique de vue à créer.
Pour plus d’informations, consultez LOGVIEWID
.
- shouldGetDocDataFromRdt
- Boolean
Si true
la valeur est , l’environnement utilise l’objet de données doc obtenu à partir de la table de documents en cours d’exécution ; sinon, le service ouvre le document à l’aide des données de document passées à docData
.
- docData
- Object
Référence à l’objet de données de document de l’élément à ouvrir ou null
. Cette valeur passée dans ce paramètre est ignorée si shouldGetDocDataFromRdt
est true
.
Retours
Tâche représentant l’opération d’ouverture. Le résultat de la tâche est un IVsAsyncOpenDocumentResult pour l’élément ouvert.
Remarques
En implémentant IVsProjectSpecificEditorMap2
l’interface sur votre objet de projet, vous pouvez effectuer une gestion des fichiers spécifique au projet. Autrement dit, vous pouvez prendre en charge l’ouverture du fichier dans un éditeur spécifique au projet ou autoriser l’éditeur global à ouvrir l’élément. L’ouverture d’un élément nécessite le lancement d’un éditeur à l’aide OpenStandardEditorAsync(...)
de ou OpenSpecificEditorAsync(...)
, selon la gestion que vous souhaitez implémenter. Pour plus d’informations, consultez GetSpecificEditorProperty
.
REMARQUE : Dans votre implémentation de , n’appelez OpenItemAsync(UInt32, Guid, Boolean, Object)Show()
pas sur le cadre de fenêtre que vous retournez.
Comparer à ReopenItemAsync(UInt32, Guid, String, Guid, Boolean, Object)
La tâche retournée par cette méthode n’indique pas que la vue et les docdata du document ont été chargées. Consultez DocumentLoadTask pour plus d’informations.