SiteCollection.Add Méthode

Référence

Définition

Espace de noms:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un nouveau site Web à la collection de sites.

Surcharges

Add(String, String, Int32)	Ajoute un nouveau site Web à la collection de sites à l’aide du nom de site, du chemin d’accès et du port de liaison spécifiés.
Add(String, String, String, Byte[])	Ajoute un nouveau site Web à la collection de sites en utilisant le nom de site, les informations de liaison, le chemin d’accès au fichier physique et le hachage de certificat spécifiés.
Add(String, String, String, String)	Crée un site à l’aide des paramètres spécifiés et l’ajoute à la collection de sites.
Add(String, String, String, Byte[], String)
Add(String, String, String, Byte[], String, SslFlags)

Add(String, String, Int32)

Ajoute un nouveau site Web à la collection de sites à l’aide du nom de site, du chemin d’accès et du port de liaison spécifiés.

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

Paramètres

name: String

Nom du nouveau site Web.

physicalPath: String

Chemin d’accès au fichier physique du nouveau site Web.

port: Int32

Port d’écoute du nouveau site Web.

Retours

Site

Objet Site qui a été ajouté à l’objet SiteCollection .

Remarques

L’objet Site est ajouté à la collection en mémoire pendant cet appel. Toutefois, pour valider la configuration du site sur le système de configuration, vous devez utiliser la ServerManager classe pour effectuer la mise à jour.

S’applique à

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

Ajoute un nouveau site Web à la collection de sites en utilisant le nom de site, les informations de liaison, le chemin d’accès au fichier physique et le hachage de certificat spécifiés.

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

Paramètres

name: String

Nom du nouveau site Web.

bindingInformation: String

Informations de liaison pour le nouveau site Web.

physicalPath: String

Chemin d’accès au fichier physique du nouveau site Web.

certificateHash: Byte[]

Hachage de certificat que le nouveau site doit utiliser pour SSL (Secure Sockets Layer).

Retours

Site

Objet Site qui a été ajouté à l’objet SiteCollection .

Remarques

Les informations de liaison de site sont une chaîne qui contient le protocole, l’adresse IP, le port TCP et l’en-tête de l’hôte. Par exemple, un site Web qui écoute les connexions HTTP sur le port 80 pour toutes les adresses IP sur le système utilise « http:*:80: » pour le bindingInformation paramètre . Notez que l’astérisque (*) est un caractère générique indiquant que le site doit écouter sur toutes les adresses IP. Dans cet exemple, l’en-tête de l’hôte a été omis. L’en-tête d’hôte peut contenir le nom de domaine du site Web et est utilisé lorsque plusieurs sites Web sont liés à la même adresse IP. Par exemple, un site Web qui écoute les connexions HTTP sur le port 80 de l’adresse IP 192.168.1.100 avec le nom de domaine « microsoft.com » utilise « http:192.168.1.100:80:microsoft.com » pour le bindingInformation paramètre .

S’applique à

Add(String, String, String, String)

Crée un site à l’aide des paramètres spécifiés et l’ajoute à la collection de sites.

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

Paramètres

name: String

Nom à attribuer au site (par exemple, « Site Web par défaut »).

bindingProtocol: String

Liste délimitée par des virgules des protocoles que le nouveau site doit utiliser.

bindingInformation: String

Jeu de données délimité par deux-points qui indique l’adresse IP, le port et les en-têtes d’hôte auxquels l’écouteur de site doit être lié.

physicalPath: String

Emplacement physique du contenu auquel ce site fournira l’accès.

Retours

Site

Référence à l’objet nouvellement créé Site .

Exceptions

FormatException

Le name paramètre passé à la méthode est null ou est une chaîne de longueur nulle.

Exemples

L’exemple suivant crée un site et met à jour le système de configuration.

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.
            }
        }
    }
}

Remarques

Cette méthode crée un Site objet et l’ajoute à l’objet SiteCollection en mémoire. Toutefois, pour valider la configuration du site sur le système de configuration, vous devez utiliser la ServerManager classe pour effectuer une mise à jour. L’instance retournée à partir de cet appel ne reflète pas les valeurs de site par défaut spécifiées dans la SiteDefaults propriété de l’objet ServerManager .

S’applique à

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

Paramètres

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

Retours

Site

S’applique à

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

Paramètres

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

sslFlags: SslFlags

Retours

Site

S’applique à

Partager via

SiteCollection.Add Méthode

Définition

Surcharges

Add(String, String, Int32)

Paramètres

Retours

Remarques

S’applique à

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

Paramètres

Retours

Remarques

S’applique à

Add(String, String, String, String)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

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

Paramètres

Retours

S’applique à

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

Paramètres

Retours

S’applique à

Ressources supplémentaires