VSProject2.WebReferencesFolder - свойство

Статья
11/19/2008

Обновлен: Ноябрь 2007

Возвращает объект ProjectItem, представляющий папку веб-ссылок проекта. Если данной папки не существует, это свойство возвращает значение Nothing (ссылка nullссылка null (Nothing в Visual Basic)).

Пространство имен: VSLangProj80
Сборка: VSLangProj80 (в VSLangProj80.dll)

Синтаксис

'Декларация
ReadOnly Property WebReferencesFolder As ProjectItem
'Применение
Dim instance As VSProject2
Dim value As ProjectItem

value = instance.WebReferencesFolder

ProjectItem WebReferencesFolder { get; }

property ProjectItem^ WebReferencesFolder {
    ProjectItem^ get ();
}

function get WebReferencesFolder () : ProjectItem

Значение свойства

Тип: EnvDTE.ProjectItem
Объект ProjectItem, представляющий папку веб-ссылок проекта.

Реализации

VSProject.WebReferencesFolder

Заметки

Веб-ссылки проекта могут быть извлечены путем доступа свойства WebReferencesFolder к свойству ProjectItems.

В проекте может содержаться только одна папка веб-ссылок. Эта папка может быть создана с помощью метода CreateWebReferencesFolder. Кроме того, эта папка создается автоматически во время добавления в проект первой веб-ссылки с помощью метода CreateWebReferencesFolder.

В проектах Visual Basic, Visual C# и Visual J# свойство Kind элемента проекта WebReferencesFolder всегда имеет значение vsProjectItemKindPhysicalFolder, поскольку проекты Visual Basic, Visual C# и Visual J# поддерживают только реально существующие файлы.

Примеры

В данном примере создается папка веб-ссылок, если таковая еще не существует, и показываются некоторые свойства этой папки в окне сообщений. О том, как выполнить этот пример в качестве надстройки, см. в разделе Практическое руководство. Компиляция и выполнение примеров кода модели объектов автоматизации. Перед выполнением данного примера откройте проект Visual Basic, Visual C# или Visual J#.

' 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, C#, or J# 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

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 C# or J# 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, J#, 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."); 
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.