VCProject.AddFile Method
Adds a file to the current project or folder.
Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)
Syntax
'Declaration
Function AddFile ( _
bstrPath As String _
) As Object
Object AddFile(
string bstrPath
)
Object^ AddFile(
String^ bstrPath
)
abstract AddFile :
bstrPath:string -> Object
function AddFile(
bstrPath : String
) : Object
Parameters
bstrPath
Type: System.StringRequired. The name of the file to add to the project or folder.
Return Value
Type: System.Object
A VCFile object for the file just added.
Remarks
AddFile behavior on a VCProject object depends on the file's extension. If a file has an extension specified with the Filter property, the file is added to the appropriate folder. Otherwise the file is placed at the end of the Solution Explorer list.
AddFile on a VCFilter object causes the file to be placed in the specified folder, regardless of the file's extension.
Adding a file in this way does not create the file on disk. The caller is responsible for handling that, if necessary.
AddFile on a VCFile object specifies the name of a file to associate with the file.
Examples
See How to: Compile Example Code for Project Model Extensibility for information about how to compile and run this example.
The following example uses AddFile on a VCProject object in the integrated development environment (IDE):
' add reference to Microsoft.VisualStudio.VCProjectEngine
Imports EnvDTE
Imports Microsoft.VisualStudio.VCProjectEngine
Public Module Module1
Sub Test()
Dim prj As VCProject
Dim file As VCFile
prj = DTE.Solution.Projects.Item(1).Object
file = prj.AddFile("file.cpp")
MsgBox(file.Name.ToString())
End Sub
End Module
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.