Udostępnij za pośrednictwem

Metoda IVsExternalFilesManager.TransferDocument — (String, String, IVsWindowFrame)

  • Artykuł

 

Przesyła dokument do projektu różne pliki.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int TransferDocument(
    string pszMkDocumentOld,
    string pszMkDocumentNew,
    IVsWindowFrame punkWindowFrame
)

int TransferDocument(
    String^ pszMkDocumentOld,
    String^ pszMkDocumentNew,
    IVsWindowFrame^ punkWindowFrame
)

abstract TransferDocument : 
        pszMkDocumentOld:string *
        pszMkDocumentNew:string *
        punkWindowFrame:IVsWindowFrame -> int

Function TransferDocument (
    pszMkDocumentOld As String,
    pszMkDocumentNew As String,
    punkWindowFrame As IVsWindowFrame
) As Integer

Parametry

  • pszMkDocumentOld
    [w] Określa oryginalnej ścieżki do plików, które mają być przeniesione.
  • pszMkDocumentNew
    [w] Określa nową ścieżkę do pliku.
  • punkWindowFrame
    [w] Określa wskaźnik do otwartego okna dla pliku.

Wartość zwracana

Type: System.Int32

Jeśli metoda się powiedzie, zwraca S_OK.Jeśli nie powiedzie się, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell.idl:

HRESULT IVsExternalFilesManager::TransferDocument(
   [in] LPCOLESTR pszMkDocumentOld,
   [in] LPCOLESTR pszMkDocumentNew,
   [in] IVsWindowFrame *punkWindowFrame
);

Jest to realizacji Otwórz plik zewnętrzny polecenia w systemie pliku menu.Jeśli projekt nie może obsłużyć ten plik projektu różne pliki (zewnętrzne) nie jest już obecny, środowiska tworzy projekt dodatkowych plików i próbuje ponownie.

W środowisku, różne pliki projektu jest realizowane przy użyciu Menedżera plików zewnętrznych (IVsExternalFilesManager).Ten interfejs umożliwia manipulowanie projektu różne pliki.

Jeśli projekt sieci World Wide Web definicji systemu projektu ściśle jest związany fakt, że strony sieci Web znajdują się w określonym katalogu, wykonywać hierarchii witryny sieci Web.Jeśli projekt zawiera plik będzie otwarty z sieci Web i użytkownik zdecyduje się czy Zapisać jako dla tego pliku i zapisać go na dyskietce, następnie ten plik może nie być dłużej uważane pliku, który należy do witryny sieci Web, ponieważ nie mieszkają w katalogu witryny sieci Web.Model środowiska Zapisać jako jest, że otwieranie edytora śledzi pliku w nowej lokalizacji.Oznacza to, że edytor nadal edycji nowego pliku w nowej lokalizacji i stary plik pozostaje bez zmian w oryginalnej lokalizacji i nie jest już otwarta.Ponieważ nowy plik jest już członkiem projektu witryny sieci Web, system projektu ręce Otwórz Edytor do projektu różne pliki.

Aby ukończyć to przeniesienie hierarchii/nr przedmiotu właściciela projektu (w tym przykładzie projektu sieci Web) wywołania Query Service dla SID_SVsExternalFilesManager otrzymać wskaźnik do IVsExternalFilesManager.Projektu następnie wywołuje TransferDocument przekazując w starym moniker dokumentu (pszMkDocumentString) dla dokumentu, gdy znajdował się w programie project w sieci Web.Moniker ten może być adres URL, adres http:// lub ścieżkę UNC i jest kluczem do oryginalnego pliku w tabeli uruchomionego dokumentu (RDT).Również przekazaniem nowych pszMkDocumentString i Otwórz nowe okno ramki wskaźnik.Różne pliki projektu, a następnie przesyła plik do jego projektu, przydziela nowy identyfikator elementu i następnie aktualizuje RDT przez wywołanie RenameDocument.Ramki okien i różne podmioty, które następnie nasłuchiwania zdarzeń RDT znać, aby zaktualizować ich odwołania do dokumentu.

Zobacz też

Interfejs IVsExternalFilesManager
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku