VirtualDirectoryCollection.Add(String, String) Método

Referência

Definição

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria um novo diretório virtual usando os parâmetros especificados e adiciona-o à coleção de diretórios virtuais.

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

Parâmetros

path: String

O caminho para o diretório virtual, em relação ao aplicativo que hospedará o diretório virtual.

physicalPath: String

O local físico em que o conteúdo do diretório virtual é armazenado.

Retornos

VirtualDirectory

Uma referência ao objeto VirtualDirectory recém-criado.

Exceções

FormatException

O caminho é null, uma cadeia de caracteres de comprimento zero ou contém caracteres retornados pelo InvalidVirtualDirectoryPathCharacters() método .

InvalidOperationException

O caminho especificado pelo path parâmetro já existe no diretório virtual.

Exemplos

O exemplo a seguir usa o Add método para criar um diretório virtual em um aplicativo.

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();

        }
    }
}

Comentários

Esse método cria um VirtualDirectory objeto e o adiciona à coleção de diretórios virtuais na memória. No entanto, para confirmar a configuração do diretório virtual no sistema de configuração, você precisará usar a ServerManager classe para executar uma atualização. A instância retornada dessa chamada não reflete os valores de aplicativo padrão especificados na VirtualDirectoryDefaults propriedade do objeto atual Application .

Aplica-se a

Compartilhar via