SiteCollection.Add Methode

Referenz

Definition

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt der Websitesammlung eine neue Website hinzu.

Überlädt

Add(String, String, Int32)	Fügt der Websitesammlung mithilfe des angegebenen Websitenamens, Pfads und Bindungsports eine neue Website hinzu.
Add(String, String, String, Byte[])	Fügt der Websitesammlung mithilfe des angegebenen Websitenamens, der Bindungsinformationen, des physischen Dateipfads und des Zertifikathashs eine neue Website hinzu.
Add(String, String, String, String)	Erstellt eine neue Website mithilfe der angegebenen Parameter und fügt sie der Websitesammlung hinzu.
Add(String, String, String, Byte[], String)
Add(String, String, String, Byte[], String, SslFlags)

Add(String, String, Int32)

Fügt der Websitesammlung mithilfe des angegebenen Websitenamens, Pfads und Bindungsports eine neue Website hinzu.

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

Parameter

name: String

Der Name der neuen Website.

physicalPath: String

Der physische Dateipfad der neuen Website.

port: Int32

Der Lauschport der neuen Website.

Gibt zurück

Site

Das Site Objekt, das dem SiteCollection Objekt hinzugefügt wurde.

Hinweise

Das Site -Objekt wird während dieses Aufrufs der Auflistung im Arbeitsspeicher hinzugefügt. Um die Standortkonfiguration jedoch in das Konfigurationssystem zu commiten, müssen Sie die ServerManager -Klasse verwenden, um das Update durchzuführen.

Gilt für:

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

Fügt der Websitesammlung mithilfe des angegebenen Websitenamens, der Bindungsinformationen, des physischen Dateipfads und des Zertifikathashs eine neue Website hinzu.

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

Parameter

name: String

Der Name der neuen Website.

bindingInformation: String

Die Bindungsinformationen für die neue Website.

physicalPath: String

Der physische Dateipfad der neuen Website.

certificateHash: Byte[]

Der Zertifikathash, den die neue Website für SSL (Secure Sockets Layer) verwenden soll.

Gibt zurück

Site

Das Site Objekt, das dem SiteCollection Objekt hinzugefügt wurde.

Hinweise

Die Websitebindungsinformationen sind eine Zeichenfolge, die das Protokoll, die IP-Adresse, den TCP-Port und den Hostheader enthält. Beispielsweise würde eine Website, die auf HTTP-Verbindungen an Port 80 für alle IP-Adressen im System lauscht, "http:*:80:" für den bindingInformation Parameter verwenden. Beachten Sie, dass das Sternchen (*) ein Platzhalterzeichen ist, das angibt, dass die Website auf alle IP-Adressen lauschen soll. In diesem Beispiel wurde der Hostheader weggelassen. Der Hostheader kann den Domänennamen der Website enthalten und wird verwendet, wenn mehrere Websites an dieselbe IP-Adresse gebunden sind. Beispielsweise würde eine Website, die auf HTTP-Verbindungen an Port 80 der IP-Adresse 192.168.1.100 mit dem Domänennamen "microsoft.com" lauscht, "http:192.168.1.100:80:microsoft.com" als bindingInformation Parameter verwenden.

Gilt für:

Add(String, String, String, String)

Erstellt eine neue Website mithilfe der angegebenen Parameter und fügt sie der Websitesammlung hinzu.

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

Parameter

name: String

Der Name, der der Website zugewiesen werden soll (z. B. "Standardwebsite").

bindingProtocol: String

Eine durch Trennzeichen getrennte Liste von Protokollen, die der neue Standort verwenden soll.

bindingInformation: String

Ein durch Doppelpunkt getrennter Datensatz, der die IP-Adresse, den Port und die Hostheader angibt, an die der Websitelistener gebunden werden soll.

physicalPath: String

Der physische Speicherort des Inhalts, auf den diese Website Zugriff bietet.

Gibt zurück

Site

Ein Verweis auf das neu erstellte Site Objekt.

Ausnahmen

FormatException

Der name Parameter, der an die -Methode übergeben wird, ist null oder ist eine Zeichenfolge der Länge null.

Beispiele

Im folgenden Beispiel wird ein Standort erstellt und das Konfigurationssystem aktualisiert.

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

Hinweise

Diese Methode erstellt ein Site -Objekt und fügt es dem SiteCollection -Objekt im Arbeitsspeicher hinzu. Um die Standortkonfiguration jedoch in das Konfigurationssystem zu commiten, müssen Sie die ServerManager -Klasse verwenden, um ein Update durchzuführen. Die von diesem Aufruf zurückgegebene Instanz spiegelt nicht die In der SiteDefaults -Eigenschaft des -Objekts angegebenen Standardwerte der ServerManager Website wider.

Gilt für:

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

Parameter

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

Gibt zurück

Site

Gilt für:

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

Parameter

name: String

bindingInformation: String

physicalPath: String

certificateHash: Byte[]

certificateStore: String

sslFlags: SslFlags

Gibt zurück

Site

Gilt für:

Freigeben über

SiteCollection.Add Methode

Definition

Überlädt

Add(String, String, Int32)

Parameter

Gibt zurück

Hinweise

Gilt für:

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

Parameter

Gibt zurück

Hinweise

Gilt für:

Add(String, String, String, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

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

Parameter

Gibt zurück

Gilt für:

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

Parameter

Gibt zurück

Gilt für:

Feedback

Zusätzliche Ressourcen