VirtualDirectoryCollection.Add(String, String) Метод

Определение

Создает новый виртуальный каталог с помощью указанных параметров и добавляет его в коллекцию виртуальных каталогов.

public:
 Microsoft::Web::Administration::VirtualDirectory ^ Add(System::String ^ path, System::String ^ physicalPath);
public Microsoft.Web.Administration.VirtualDirectory Add(string path, string physicalPath);
override this.Add : string * string -> Microsoft.Web.Administration.VirtualDirectory
Public Function Add (path As String, physicalPath As String) As VirtualDirectory

Параметры

path
String

Путь к виртуальному каталогу относительно приложения, в котором будет размещаться виртуальный каталог.

physicalPath
String

Физическое расположение, в котором хранится содержимое виртуального каталога.

Возвращаемое значение

Ссылка на только что созданный VirtualDirectory объект.

Исключения

Путь имеет nullзначение , строка нулевой длины или содержит символы, возвращаемые методом InvalidVirtualDirectoryPathCharacters() .

Путь, указанный параметром path , уже существует в виртуальном каталоге.

Примеры

В следующем примере используется Add метод для создания виртуального каталога в приложении.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Web.Administration;
using Microsoft.Web.Management;

namespace AdministrationSnippets
{
    class AdministrationVirtualDirectoryCollectionItem2
    {
        public void VirtualDirectoryAddGet()
        {
            ServerManager manager = new ServerManager();
            Site defaultSite = manager.Sites["Default Web Site"];

            ApplicationPool blogPool = manager.ApplicationPools.Add("PhotoApplicationPool");
            Application app = defaultSite.Applications.Add("/photo", @"C:\inetpub\wwwroot\photo");
            app.VirtualDirectories.Add("/family", @"C:\photos\family");
            manager.CommitChanges();
        }
    }
}

Комментарии

Этот метод создает VirtualDirectory объект и добавляет его в коллекцию виртуальных каталогов в памяти. Однако для фиксации конфигурации виртуального каталога в системе конфигурации ServerManager необходимо использовать класс для выполнения обновления. Экземпляр, возвращаемый этим вызовом, не отражает значения приложения по умолчанию, указанные в свойстве VirtualDirectoryDefaults текущего Application объекта .

Применяется к