VSProject2.WebReferencesFolder Property

Definition

Namespace:

VSLangProj80

Assembly:

Microsoft.VisualStudio.Interop.dll

Gets the ProjectItem object representing the Web References folder of the project. If the folder does not exist, this property returns Nothing (a null reference).

public:
 property EnvDTE::ProjectItem ^ WebReferencesFolder { EnvDTE::ProjectItem ^ get(); };

public:
 property EnvDTE::ProjectItem ^ WebReferencesFolder { EnvDTE::ProjectItem ^ get(); };

[System.Runtime.InteropServices.DispId(6)]
public EnvDTE.ProjectItem WebReferencesFolder { [System.Runtime.InteropServices.DispId(6)] get; }

[<System.Runtime.InteropServices.DispId(6)>]
[<get: System.Runtime.InteropServices.DispId(6)>]
member this.WebReferencesFolder : EnvDTE.ProjectItem

Public ReadOnly Property WebReferencesFolder As ProjectItem

Property Value

ProjectItem

A ProjectItem object representing the Web References folder.

Implements

WebReferencesFolder

Attributes

DispIdAttribute

Examples

This example creates a Web references folder, if one does not already exist, and displays some of the folder properties in a message box. To run this example as an add-in, see How to: Compile and Run the Automation Object Model Code Examples. Open a Visual Basic or Visual C# project before running this example.

[Visual Basic]

' Add-in code.  
' This example creates a Web references folder, if it does not   
' already exist, and displays some of the folder properties.  
Imports VSLangProj  
Imports VSLangProj80  
Public Sub OnConnection(ByVal application As Object _  
, ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _  
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection  
    applicationObject = CType(application, DTE2)  
    addInInstance = CType(addInInst, AddIn)  
    WebReferencesFolderExample(applicationObject)  
End Sub  

Sub WebReferencesFolderExample(ByVal dte As DTE2)  
    ' This example assumes that the first project in the   
    ' solution is a Visual Basic or C# project.  
    Dim aVSProject As VSProject2 = _  
    CType(applicationObject.Solution.Projects.Item(1)._  
    Object, VSProject2)  

    ' Add a new folder if it does not already exist.  
    If (aVSProject.WebReferencesFolder Is Nothing) Then  
        Dim newFolder As ProjectItem  
        newFolder = aVSProject.CreateWebReferencesFolder()  
    End If  

    ' Display the name of the Web references folder.  
    Dim theFolder As ProjectItem = aVSProject.WebReferencesFolder  
    MsgBox("The name of the WebReferences folder is " _  
    & theFolder.Name & ".")  

    ' All Visual Basic and C# Web references folders are physical.  
    If (theFolder.Kind = _  
    EnvDTE.Constants.vsProjectItemKindPhysicalFolder) Then  
        MsgBox(theFolder.Name & " is a physical folder.")  
    End If  

    MsgBox("There are " & theFolder.ProjectItems.Count.ToString() & _  
    " Web references.")  
End Sub  

[C#]

using System.Windows.Forms;  
using VSLangProj;  
using VSLangProj2;  
using VSLangProj80;  

public void OnConnection(object application, ext_ConnectMode  
 connectMode, object addInInst, ref Array custom)  
{  
    applicationObject = (DTE2)application;  
    addInInstance = (AddIn)addInInst;  
    WebReferencesFolderExample((DTE2)applicationObject);  
}  

public void WebReferencesFolderExample( DTE2 dte )   
{   
    // This example assumes that the first project in the   
    // solution is a Visual Basic or C# project.  
    VSProject2 aVSProject = ( ( VSProject2 )  
(applicationObject.Solution.Projects.Item( 1 ).Object ) );   
    // Add a new folder if it does not already exist.  
    if ( ( aVSProject.WebReferencesFolder == null ) )   
    {   
        ProjectItem newFolder = null;   
        newFolder = aVSProject.CreateWebReferencesFolder();   
    }   
    // Display the name of the Web references folder.  
    ProjectItem theFolder = aVSProject.WebReferencesFolder;   
    MessageBox.Show( "The name of the WebReferences folder is "   
+ theFolder.Name + ".");   
    // All Visual Basic and C# Web references folders are physical.  
    if ( ( theFolder.Kind ==   
EnvDTE.Constants.vsProjectItemKindPhysicalFolder ) )   
    {   
        MessageBox.Show( theFolder.Name + " is a physical folder.");   
    }   
    MessageBox.Show( "There are " +  
 theFolder.ProjectItems.Count.ToString() + " Web references.");   
}  

Remarks

A project's Web references may be retrieved by accessing the ProjectItems property of the WebReferencesFolder.

A project contains at most one Web References folder. The folder may be created by using the CreateWebReferencesFolder method. In addition, the folder is created automatically when the first Web reference is added to the project by using the CreateWebReferencesFolder method.

In a Visual Basic or Visual C# project, the Kind property of the WebReferencesFolder project item is always vsProjectItemKindPhysicalFolder because Visual Basic and Visual C# projects support only physical files.