VirtualDirectoryCollection.Add(String, String) Método

Definición

Espacio de nombres:

Microsoft.Web.Administration

Ensamblado:

Microsoft.Web.Administration.dll

Crea un nuevo directorio virtual mediante los parámetros especificados y lo agrega a la colección de directorios virtuales.

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

Ruta de acceso al directorio virtual, en relación con la aplicación que hospedará el directorio virtual.

physicalPath

String

Ubicación física donde se almacena el contenido del directorio virtual.

Devoluciones

VirtualDirectory

Referencia al objeto VirtualDirectory recién creado.

Excepciones

FormatException

La ruta de acceso es null, una cadena de longitud cero o contiene caracteres devueltos por el InvalidVirtualDirectoryPathCharacters() método .

InvalidOperationException

La ruta de acceso especificada por el path parámetro ya existe en el directorio virtual.

Ejemplos

En el ejemplo siguiente se usa el Add método para crear un directorio virtual en una aplicación.

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

        }
    }
}

Comentarios

Este método crea un VirtualDirectory objeto y lo agrega a la colección de directorios virtuales en memoria. Sin embargo, para confirmar la configuración del directorio virtual en el sistema de configuración, deberá usar la ServerManager clase para realizar una actualización. La instancia devuelta desde esta llamada no refleja los valores de aplicación predeterminados especificados en la VirtualDirectoryDefaults propiedad del objeto actual Application .