Compartilhar via


IVsExternalFilesManager Interface

Implemented by the environment to handle the Miscellaneous Files project.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
<InterfaceTypeAttribute()> _
<GuidAttribute("E36756DE-BB4F-4900-A7F0-E827BDBD2092")> _
Public Interface IVsExternalFilesManager
[InterfaceTypeAttribute()]
[GuidAttribute("E36756DE-BB4F-4900-A7F0-E827BDBD2092")]
public interface IVsExternalFilesManager
[InterfaceTypeAttribute()]
[GuidAttribute(L"E36756DE-BB4F-4900-A7F0-E827BDBD2092")]
public interface class IVsExternalFilesManager
[<InterfaceTypeAttribute()>]
[<GuidAttribute("E36756DE-BB4F-4900-A7F0-E827BDBD2092")>]
type IVsExternalFilesManager =  interface end
public interface IVsExternalFilesManager

The IVsExternalFilesManager type exposes the following members.

Methods

  Name Description
Public method AddDocument Programmatically tells the Miscellaneous Files project to add a node.
Public method GetExternalFilesProject Instantiates the Miscellaneous Files (External Files) project and returns a pointer to it.
Public method IsVisible Determines whether the Miscellaneous Files node is visible in Solution Explorer.
Public method TransferDocument Transfers a document to the Miscellaneous Files project.

Top

Remarks

Call this function when your project system needs to handle external files. HierUtil7 is a class library that implements many of the elements needed in a custom project. The files vsdoc.cpp and hu_util.cpp, found in <envsdk>\common\HierUtil7 folder, show implementations of IVsExternalFilesManger. Additionally, Saving a Standard Document shows how to change a file's ownership to the Miscellaneous Files project.

Notes to Implementers

IVsExternalFilesManager is implemented by the Miscellaneous Files (External Files) project. For example, to handle files from "directory-based" project systems, the environment hands an open file to the Miscellaneous Files project after a Save As operation saves the file outside of the original directory of the project.

To access this interface, call Query Service on SVsExternalFilesManager Service and pass in a value of IID_IVsExternalFilesManager.

Note

The Miscellaneous Files project is listed in Solution Explorer. By default, the node is not visible. To make it visible, select Options on the Tools menu. In the Options dialog box, open the Environment folder and choose Documents. On the Documents tab, select the Show Miscellaneous files in Solution Explorer

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace