SiteCollection.Add 메서드

정의

사이트 모음에 새 웹 사이트를 추가합니다.

오버로드

Add(String, String, Int32)

지정된 사이트 이름, 경로 및 바인딩 포트를 사용하여 사이트 모음에 새 웹 사이트를 추가합니다.

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

지정된 사이트 이름, 바인딩 정보, 실제 파일 경로 및 인증서 해시를 사용하여 사이트 모음에 새 웹 사이트를 추가합니다.

Add(String, String, String, String)

지정된 매개 변수를 사용하여 새 사이트를 만들고 사이트 모음에 추가합니다.

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

Add(String, String, Int32)

지정된 사이트 이름, 경로 및 바인딩 포트를 사용하여 사이트 모음에 새 웹 사이트를 추가합니다.

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

매개 변수

name
String

새 웹 사이트의 이름입니다.

physicalPath
String

새 웹 사이트의 실제 파일 경로입니다.

port
Int32

새 웹 사이트의 수신 대기 포트입니다.

반환

Site 개체에 추가된 개체입니다SiteCollection.

설명

개체는 Site 이 호출 중에 메모리의 컬렉션에 추가됩니다. 그러나 사이트 구성을 구성 시스템에 커밋하려면 클래스를 ServerManager 사용하여 업데이트를 수행해야 합니다.

적용 대상

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

지정된 사이트 이름, 바인딩 정보, 실제 파일 경로 및 인증서 해시를 사용하여 사이트 모음에 새 웹 사이트를 추가합니다.

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

매개 변수

name
String

새 웹 사이트의 이름입니다.

bindingInformation
String

새 웹 사이트에 대한 바인딩 정보입니다.

physicalPath
String

새 웹 사이트의 실제 파일 경로입니다.

certificateHash
Byte[]

새 사이트에서 SSL(Secure Sockets Layer)에 사용해야 하는 인증서 해시입니다.

반환

Site 개체에 추가된 개체입니다SiteCollection.

설명

사이트 바인딩 정보는 프로토콜, IP 주소, TCP 포트 및 호스트 헤더를 포함하는 문자열입니다. 예를 들어 시스템의 모든 IP 주소에 대해 포트 80에서 HTTP 연결을 수신 대기하는 웹 사이트는 매개 변수에 "http:*:80:"을 bindingInformation 사용합니다. 별표(*)는 사이트가 모든 IP 주소에서 수신 대기해야 함을 나타내는 와일드카드 문자입니다. 이 예제에서는 호스트 헤더를 생략했습니다. 호스트 헤더는 웹 사이트의 도메인 이름을 포함할 수 있으며 둘 이상의 웹 사이트가 동일한 IP 주소에 바인딩된 경우에 사용됩니다. 예를 들어 도메인 이름이 "microsoft.com"인 IP 주소 192.168.1.100 포트 80에서 HTTP 연결을 수신 대기하는 웹 사이트는 매개 변수에 "http:192.168.1.100:80:microsoft.com"을 bindingInformation 사용합니다.

개체는 Site 이 호출 중에 메모리의 컬렉션에 추가됩니다. 그러나 사이트 구성을 구성 시스템에 커밋하려면 클래스를 ServerManager 사용하여 업데이트를 수행해야 합니다.

적용 대상

Add(String, String, String, String)

지정된 매개 변수를 사용하여 새 사이트를 만들고 사이트 모음에 추가합니다.

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

매개 변수

name
String

사이트에 할당할 이름입니다(예: "기본 웹 사이트").

bindingProtocol
String

새 사이트에서 사용해야 하는 쉼표로 구분된 프로토콜 목록입니다.

bindingInformation
String

사이트 수신기가 바인딩해야 하는 IP 주소, 포트 및 호스트 헤더를 나타내는 콜론으로 구분된 데이터 집합입니다.

physicalPath
String

이 사이트에서 액세스할 수 있는 콘텐츠의 물리적 위치입니다.

반환

새로 만든 Site 개체에 대한 참조입니다.

예외

name 메서드에 전달되는 매개 변수는 이거나 null 길이가 0인 문자열입니다.

예제

다음 예제에서는 사이트를 만들고 구성 시스템을 업데이트합니다.

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

설명

이 메서드는 개체를 Site 만들고 메모리의 개체에 SiteCollection 추가합니다. 그러나 사이트 구성을 구성 시스템에 커밋하려면 클래스를 ServerManager 사용하여 업데이트를 수행해야 합니다. 이 호출에서 반환된 인스턴스는 개체의 ServerManager 속성에 SiteDefaults 지정된 기본 사이트 값을 반영하지 않습니다.

적용 대상

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

매개 변수

name
String
bindingInformation
String
physicalPath
String
certificateHash
Byte[]
certificateStore
String

반환

적용 대상

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

매개 변수

name
String
bindingInformation
String
physicalPath
String
certificateHash
Byte[]
certificateStore
String
sslFlags
SslFlags

반환

적용 대상