SiteCollection.Add Método

Referencia

Definición

Espacio de nombres:: Microsoft.Web.Administration

Ensamblado:: Microsoft.Web.Administration.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega un nuevo sitio web a la colección de sitios.

Sobrecargas

Add(String, String, Int32)	Agrega un nuevo sitio web a la colección de sitios mediante el nombre de sitio, la ruta de acceso y el puerto de enlace especificados.
Add(String, String, String, Byte[])	Agrega un nuevo sitio web a la colección de sitios mediante el nombre de sitio, la información de enlace, la ruta de acceso física del archivo y el hash de certificado especificados.
Add(String, String, String, String)	Crea un nuevo sitio mediante los parámetros especificados y lo agrega a la colección de sitios.
Add(String, String, String, Byte[], String)
Add(String, String, String, Byte[], String, SslFlags)

Add(String, String, Int32)

Agrega un nuevo sitio web a la colección de sitios mediante el nombre de sitio, la ruta de acceso y el puerto de enlace especificados.

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ physicalPath, int port);

public Microsoft.Web.Administration.Site Add (string name, string physicalPath, int port);

override this.Add : string * string * int -> Microsoft.Web.Administration.Site

Public Function Add (name As String, physicalPath As String, port As Integer) As Site

Parámetros

name: String

Nombre del nuevo sitio web.

physicalPath: String

Ruta de acceso del archivo físico del nuevo sitio web.

port: Int32

Puerto de escucha del nuevo sitio web.

Devoluciones

Site

Objeto Site que se agregó al SiteCollection objeto .

Comentarios

El Site objeto se agrega a la colección en memoria durante esta llamada. Sin embargo, para confirmar la configuración del sitio en el sistema de configuración, deberá usar la ServerManager clase para realizar la actualización.

Se aplica a

Add(String, String, String, Byte[])

Agrega un nuevo sitio web a la colección de sitios mediante el nombre de sitio, la información de enlace, la ruta de acceso física del archivo y el hash de certificado especificados.

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingInformation, System::String ^ physicalPath, cli::array <System::Byte> ^ certificateHash);

public Microsoft.Web.Administration.Site Add (string name, string bindingInformation, string physicalPath, byte[] certificateHash);

override this.Add : string * string * string * byte[] -> Microsoft.Web.Administration.Site

Public Function Add (name As String, bindingInformation As String, physicalPath As String, certificateHash As Byte()) As Site

Parámetros

name: String

Nombre del nuevo sitio web.

bindingInformation: String

Información de enlace del nuevo sitio web.

physicalPath: String

Ruta de acceso del archivo físico del nuevo sitio web.

certificateHash: Byte[]

Hash de certificado que el nuevo sitio debe usar para Capa de sockets seguros (SSL).

Devoluciones

Site

Objeto Site que se agregó al SiteCollection objeto .

Comentarios

La información de enlace de sitio es una cadena que contiene el protocolo, la dirección IP, el puerto TCP y el encabezado de host. Por ejemplo, un sitio web que escucha conexiones HTTP en el puerto 80 para todas las direcciones IP del sistema usaría "http:*:80:" para el bindingInformation parámetro . Tenga en cuenta que el asterisco (*) es un carácter comodín que indica que el sitio debe escuchar en todas las direcciones IP. En este ejemplo, se omitió el encabezado host. El encabezado de host puede contener el nombre de dominio del sitio web y se usa cuando más de un sitio web está enlazado a la misma dirección IP. Por ejemplo, un sitio web que escucha conexiones HTTP en el puerto 80 de la dirección IP 192.168.1.100 con un nombre de dominio de "microsoft.com" usaría "http:192.168.1.100:80:microsoft.com" para el bindingInformation parámetro .

Se aplica a

Add(String, String, String, String)

Crea un nuevo sitio mediante los parámetros especificados y lo agrega a la colección de sitios.

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingProtocol, System::String ^ bindingInformation, System::String ^ physicalPath);

public Microsoft.Web.Administration.Site Add (string name, string bindingProtocol, string bindingInformation, string physicalPath);

override this.Add : string * string * string * string -> Microsoft.Web.Administration.Site

Public Function Add (name As String, bindingProtocol As String, bindingInformation As String, physicalPath As String) As Site

Parámetros

name: String

Nombre que se va a asignar al sitio (por ejemplo, "Sitio web predeterminado").

bindingProtocol: String

Lista delimitada por comas de protocolos que debe usar el nuevo sitio.

bindingInformation: String

Conjunto de datos delimitado por dos puntos que indica la dirección IP, el puerto y los encabezados de host a los que se debe enlazar el agente de escucha del sitio.

physicalPath: String

Ubicación física del contenido al que este sitio proporcionará acceso.

Devoluciones

Site

Referencia al objeto Site recién creado.

Excepciones

FormatException

El name parámetro que se pasa al método es null o es una cadena de longitud cero.

Ejemplos

En el ejemplo siguiente se crea un sitio y se actualiza el sistema de configuración.

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

namespace AdministrationSnippets
{
    class MicrosoftWebAdministrationSite
    {// Creates an site named HRWeb
        public void CreateSite()
        {
            CreateSiteByName("HRWeb");
        }

        // Creates a new site with the specified name
        public void CreateSiteByName(string name)
        {
            string path = @"C:\inetpub\" + name + "site";

            // Validate the site name
            char[] invalid = SiteCollection.InvalidSiteNameCharacters();
            if (name.IndexOfAny(invalid) > -1)
            {
                Console.WriteLine("Invalid site name: {0}", name);
            }

            // Create the content directory if it doesn't exist.
            if (!System.IO.Directory.Exists(path))
            {
                System.IO.Directory.CreateDirectory(path);
            }

            // Create a new site using the new directory and update the config
            ServerManager manager = new ServerManager();
            try
            {   // Add this site.
                Site hrSite = manager.Sites.Add(name, "http", "*:9090:", path);
                // The site will need to be started manually.
                hrSite.ServerAutoStart = false;
                manager.CommitChanges();
                Console.WriteLine("Site " + name + " added to ApplicationHost.config file.");
            }
            catch
            {
                // A site with this binding already exists. Do not attempt
                // to add a duplicate site.
            }
        }
    }
}

Comentarios

Este método crea un Site objeto y lo agrega al SiteCollection objeto en memoria. Sin embargo, para confirmar la configuración del sitio 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 sitio predeterminados especificados en la SiteDefaults propiedad del ServerManager objeto .

Se aplica a

Add(String, String, String, Byte[], String)

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingInformation, System::String ^ physicalPath, cli::array <System::Byte> ^ certificateHash, System::String ^ certificateStore);

public Microsoft.Web.Administration.Site Add (string name, string bindingInformation, string physicalPath, byte[] certificateHash, string certificateStore);

override this.Add : string * string * string * byte[] * string -> Microsoft.Web.Administration.Site

Public Function Add (name As String, bindingInformation As String, physicalPath As String, certificateHash As Byte(), certificateStore As String) As Site

Parámetros

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

Devoluciones

Site

Se aplica a

Add(String, String, String, Byte[], String, SslFlags)

public:
 Microsoft::Web::Administration::Site ^ Add(System::String ^ name, System::String ^ bindingInformation, System::String ^ physicalPath, cli::array <System::Byte> ^ certificateHash, System::String ^ certificateStore, Microsoft::Web::Administration::SslFlags sslFlags);

public Microsoft.Web.Administration.Site Add (string name, string bindingInformation, string physicalPath, byte[] certificateHash, string certificateStore, Microsoft.Web.Administration.SslFlags sslFlags);

override this.Add : string * string * string * byte[] * string * Microsoft.Web.Administration.SslFlags -> Microsoft.Web.Administration.Site

Parámetros

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

sslFlags: SslFlags

Devoluciones

Site

Se aplica a

Compartir a través de

SiteCollection.Add Método

Definición

Sobrecargas

Add(String, String, Int32)

Parámetros

Devoluciones

Comentarios

Se aplica a

Add(String, String, String, Byte[])

Parámetros

Devoluciones

Comentarios

Se aplica a

Add(String, String, String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Se aplica a

Add(String, String, String, Byte[], String)

Parámetros

Devoluciones

Se aplica a

Add(String, String, String, Byte[], String, SslFlags)

Parámetros

Devoluciones

Se aplica a

Recursos adicionales