Wyświetlanie plików za pomocą polecenia Otwórz plik

W poniższych krokach opisano, jak środowisko IDE obsługuje polecenie Otwórz plik , które jest dostępne w menu Plik w programie Visual Studio. W krokach opisano również sposób reagowania projektów na wywołania pochodzące z tego polecenia.

Gdy użytkownik kliknie polecenie Otwórz plik w menu Plik i wybierze plik w oknie dialogowym Otwieranie pliku , następuje następujący proces:

  1. Korzystając z uruchomionej tabeli dokumentów, środowisko IDE określa, czy plik jest już otwarty w projekcie.

    • Jeśli plik jest otwarty, środowisko IDE ponownie wyświetli okno.

    • Jeśli plik nie jest otwarty, środowisko IDE wywołuje zapytanie IsDocumentInProject dotyczące każdego projektu w celu określenia, który projekt może otworzyć plik.

      Uwaga

      W implementacji projektu programu podaj wartość priorytetu IsDocumentInProjectwskazującą poziom, na którym projekt otwiera plik. Wartości priorytetów są podane w wyliczeniem VSDOCUMENTPRIORITY .

  2. Każdy projekt odpowiada z poziomem priorytetu, który wskazuje znaczenie, jakie umieszcza w projekcie w celu otwarcia pliku.

  3. Środowisko IDE używa następujących kryteriów, aby określić, który projekt otwiera plik:

    • Projekt, który odpowiada z najwyższym priorytetem (DP_Intrinsic) otwiera plik. Jeśli więcej niż jeden projekt odpowiada z tym priorytetem, pierwszy projekt, który odpowie, otwiera plik.

    • Jeśli żaden projekt nie odpowiada z najwyższym priorytetem (DP_Intrinsic), ale wszystkie projekty odpowiadają z tym samym, niższym priorytetem, aktywny projekt otwiera plik. Jeśli żaden projekt nie jest aktywny, pierwszy projekt, który odpowie, otwiera plik.

    • Jeśli żaden projekt nie przejmuje własności pliku (DP_Unsupported), zostanie otwarty projekt Różne pliki.

      Jeśli zostanie utworzone wystąpienie projektu Różne pliki, projekt zawsze odpowiada wartością DP_CanAddAsExternal. Ta wartość wskazuje, że projekt może otworzyć plik. Ten projekt służy do obsługi otwartych plików, które nie znajdują się w żadnym innym projekcie. Lista elementów w tym projekcie nie jest utrwalone; ten projekt jest widoczny w Eksplorator rozwiązań tylko wtedy, gdy jest używany do otwierania pliku.

      Jeśli projekt Różne pliki nie wskazuje, że może otworzyć plik, wystąpienie projektu nie zostało utworzone. W takim przypadku środowisko IDE tworzy wystąpienie projektu Różne pliki i informuje projekt o otwarciu pliku.

  4. Gdy tylko środowisko IDE określi, który projekt otworzy plik, wywołuje metodę OpenItem w tym projekcie.

  5. Następnie projekt ma możliwość otwarcia pliku przy użyciu edytora specyficznego dla projektu lub edytora standardowego. Aby uzyskać więcej informacji, zobacz Instrukcje: otwieranie edytorów specyficznych dla projektu i Instrukcje: otwieranie edytorów standardowych.