IVsTrackProjectDocuments2 Schnittstelle

Definition

Wird von Projekten verwendet, um die Umgebung nach Berechtigungen für das Hinzufügen, Entfernen oder Unbenennen einer Datei oder eines Verzeichnisses in einer Projektmappe abzufragen.

public interface class IVsTrackProjectDocuments2
public interface class IVsTrackProjectDocuments2
__interface IVsTrackProjectDocuments2
[System.Runtime.InteropServices.Guid("53544C4D-6639-11D3-A60D-005004775AB1")]
[System.Runtime.InteropServices.InterfaceType(1)]
public interface IVsTrackProjectDocuments2
[<System.Runtime.InteropServices.Guid("53544C4D-6639-11D3-A60D-005004775AB1")>]
[<System.Runtime.InteropServices.InterfaceType(1)>]
type IVsTrackProjectDocuments2 = interface
Public Interface IVsTrackProjectDocuments2
Attribute

Hinweise

Verwenden Sie die IVsTrackProjectDocuments2 -Schnittstelle, um Berechtigungen aus der Umgebung anzufordern, um Dateien oder Verzeichnisse in einem Projekt hinzuzufügen, zu entfernen oder umzubenennen, und (wenn die Berechtigung erteilt wird), um die Umgebung zu informieren, wenn diese Aktionen abgeschlossen sind. Sie müssen diese Aufrufe auch dann vornehmen, wenn das Projekt keine Quell Code Verwaltung unterstützt. Sie müssen IVsTrackProjectDocuments2 für alle Dateien verwenden, nicht nur für Master Dateien. Wenn Sie z. b. ein Formular mit einer RESX-Datei und anderen Dateien haben, müssen Sie die Umgebung über alle Dateien informieren. Nennen Sie die Methoden von IVsTrackProjectDocuments2 beim Öffnen oder Schließen des Projekts nicht. Jede Entität, die die durch beim Start von bereitgestellten Informationen erfordert, IVsTrackProjectDocuments2 kann auf das OnAfterOpenSolution Ereignis warten und die Projekt Mappe durchlaufen, um die erforderlichen Informationen zu finden. Beim Herunterfahren sind diese Informationen nicht erforderlich. Der Zugriff auf IVsTrackProjectDocuments2 wird vom- SVsTrackProjectDocuments Dienst bereitgestellt.

Für jeden-Rückruf von IVsTrackProjectDocuments2 gibt es zwei Methoden: die OnQuery* -Methode und die- OnAfter* Methode. Ruft die entsprechende- OnQuery* Methode auf, um die Berechtigung zum Hinzufügen, entfernen oder Umbenennen einer Datei oder eines Verzeichnisses in einem Projekt anzufordern. Bei diesem Befehl erhalten Sie möglicherweise eine Benachrichtigung, dass der Vorgang nicht fortgesetzt werden kann. Wenn das Projekt System von Enterprise Framework und Template (EFT) z. b. nicht zulässt, dass der Benutzer eine Datei hinzufügt, die die Richtlinie nicht erfüllt, muss das Projekt darauf vorbereitet sein, das Hinzufügen, entfernen oder Umbenennen nicht auszuführen. Wenn die Berechtigung erteilt wird, muss das Projekt die Aktion zum Hinzufügen, umbenennen oder entfernen ausführen und dann die entsprechende OnAfter* Methode zum informieren der Umgebung über die an dem Projekt vorgenommenen Änderungen aufruft.

Die- IVsTrackProjectDocuments2 Methode gilt auch für Verzeichnisse, aber Verzeichnis Aufrufe sind optional. Wenn das Projekt System über Verzeichnisinformationen verfügt, geben Sie diese Informationen mithilfe dieser Methoden der Umgebung an. Wenn das Projekt System diese Informationen jedoch nicht enthält, wird es von der Umgebung abgeleitet.

Hinweis

Alle Verzeichnis Aufrufe sind optional. Wenn Sie jedoch eine der OnQuery* Verzeichnis Methoden aufzurufen und der-Befehl erfolgreich ausgeführt wurde, müssen Sie die entsprechende- OnAfter* Verzeichnis Methode aufzurufen.

IVsTrackProjectDocuments2 der Zugriff erfolgt über den- SVsTrackProjectDocuments Dienst.

Hinweise für Ausführende

Wird von der Umgebung implementiert. Diese Schnittstelle stellt den Mechanismus dar, mit dem die Informationen in Bezug auf das Hinzufügen, entfernen oder Umbenennen einer Datei oder eines Verzeichnisses in einem Projekt gesammelt werden.

Hinweise für Aufrufer

Wird von Projekten aufgerufen, um die Umgebung abzufragen, ob eine Datei oder ein Verzeichnis in einer Projekt Mappe hinzugefügt, entfernt oder umbenannt werden kann. Für alle Aktionen, die von der Umgebung genehmigt werden, wird die entsprechende Methode aufgerufen, nachdem die Aktion abgeschlossen wurde. IVsTrackProjectDocuments2 muss von allen Projekten verwendet werden, unabhängig davon, ob Sie die Quell Code Verwaltung unterstützen.

Methoden

AdviseTrackProjectDocumentsEvents(IVsTrackProjectDocumentsEvents2, UInt32)

Diese Methode ermöglicht Clients, Benachrichtigungen von Projektdokumentereignissen zu empfangen.

BeginBatch()

Diese Methode startet einen Batch von IVsTrackProjectDocuments2. onafter *-Methoden aufrufen.

EndBatch()

Diese Methode beendet den Batch, der von BeginBatch() gestartet wurde, und zeigt jede Benutzeroberfläche an, die im Batch generiert wurde.

Flush()

Diese Methode zeigt die Benutzeroberfläche für die bisher erledigten IVsTrackProjectDocuments2-Aufrufe, ohne den Batch zu beenden.

OnAfterAddDirectories(IVsProject, Int32, String[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Verzeichnisse dem Projekt hinzugefügt wurden.

OnAfterAddDirectoriesEx(IVsProject, Int32, String[], VSADDDIRECTORYFLAGS[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Verzeichnisse dem Projekt hinzugefügt wurden. Diese Methode entspricht OnAfterAddDirectories(IVsProject, Int32, String[]), übernimmt aber auch Flags.

OnAfterAddFiles(IVsProject, Int32, String[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Dateien dem Projekt hinzugefügt wurden.

OnAfterAddFilesEx(IVsProject, Int32, String[], VSADDFILEFLAGS[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Dateien dem Projekt hinzugefügt wurden.

OnAfterRemoveDirectories(IVsProject, Int32, String[], VSREMOVEDIRECTORYFLAGS[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Verzeichnisse aus dem Projekt entfernt wurden.

OnAfterRemoveFiles(IVsProject, Int32, String[], VSREMOVEFILEFLAGS[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Dateien aus dem Projekt entfernt wurden.

OnAfterRenameDirectories(IVsProject, Int32, String[], String[], VSRENAMEDIRECTORYFLAGS[])

Diese Methode wird von einem Projekt aufgerufen, nachdem ein Verzeichnis im Projekt umbenannt wurde.

OnAfterRenameFile(IVsProject, String, String, VSRENAMEFILEFLAGS)

Diese Methode wird von einem Projekt aufgerufen, nachdem eine Datei im Projekt umbenannt wurde.

OnAfterRenameFiles(IVsProject, Int32, String[], String[], VSRENAMEFILEFLAGS[])

Diese Methode wird von einem Projekt aufgerufen, nachdem Dateien im Projekt umbenannt wurden.

OnAfterSccStatusChanged(IVsProject, Int32, String[], UInt32[])

Diese Methode wird von der Quellcode-Verwaltungsstub aufgerufen, um Listener zu informieren, dass sich der Quellcodeverwaltungsstatus geändert hat. Rufen Sie diese Methode nicht auf.

OnQueryAddDirectories(IVsProject, Int32, String[], VSQUERYADDDIRECTORYFLAGS[], VSQUERYADDDIRECTORYRESULTS[], VSQUERYADDDIRECTORYRESULTS[])

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob Verzeichnisse dem Projekt hinzugefügt werden können.

OnQueryAddFiles(IVsProject, Int32, String[], VSQUERYADDFILEFLAGS[], VSQUERYADDFILERESULTS[], VSQUERYADDFILERESULTS[])

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob Dateien dem Projekt hinzugefügt werden können.

OnQueryRemoveDirectories(IVsProject, Int32, String[], VSQUERYREMOVEDIRECTORYFLAGS[], VSQUERYREMOVEDIRECTORYRESULTS[], VSQUERYREMOVEDIRECTORYRESULTS[])

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob Verzeichnisse aus dem Projekt entfernt werden können.

OnQueryRemoveFiles(IVsProject, Int32, String[], VSQUERYREMOVEFILEFLAGS[], VSQUERYREMOVEFILERESULTS[], VSQUERYREMOVEFILERESULTS[])

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob Dateien aus dem Projekt entfernt werden können.

OnQueryRenameDirectories(IVsProject, Int32, String[], String[], VSQUERYRENAMEDIRECTORYFLAGS[], VSQUERYRENAMEDIRECTORYRESULTS[], VSQUERYRENAMEDIRECTORYRESULTS[])

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob Verzeichnisse im Projekt umbenannt werden können.

OnQueryRenameFile(IVsProject, String, String, VSRENAMEFILEFLAGS, Int32)

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob eine Datei im Projekt umbenannt werden kann.

OnQueryRenameFiles(IVsProject, Int32, String[], String[], VSQUERYRENAMEFILEFLAGS[], VSQUERYRENAMEFILERESULTS[], VSQUERYRENAMEFILERESULTS[])

Diese Methode wird von einem Projekt aufgerufen, um zu bestimmen, ob Datei im Projekt umbenannt werden können.

UnadviseTrackProjectDocumentsEvents(UInt32)

Diese Methode hindert Clients am Empfangen von Benachrichtigungen von Projektdokumentereignissen.

Gilt für