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 объекта .