BindingCollection.Add 메서드

정의

네임스페이스:

Microsoft.Web.Administration

어셈블리:

Microsoft.Web.Administration.dll

바인딩 컬렉션에 HTTP 또는 HTTPS 바인딩을 추가합니다.

오버로드

Add(Binding)	컬렉션의 끝에 보안 바인딩을 추가합니다.
Add(String, String)	지정된 프로토콜 및 바인딩 정보가 포함된 바인딩을 바인딩 컬렉션에 추가합니다.
Add(String, Byte[], String)	바인딩 컬렉션에 보안 바인딩을 추가합니다.
Add(String, Byte[], String, SslFlags)

Add(Binding)

컬렉션의 끝에 보안 바인딩을 추가합니다.

public:
 Microsoft::Web::Administration::Binding ^ Add(Microsoft::Web::Administration::Binding ^ binding);

public Microsoft.Web.Administration.Binding Add (Microsoft.Web.Administration.Binding binding);

override this.Add : Microsoft.Web.Administration.Binding -> Microsoft.Web.Administration.Binding

매개 변수

binding

Binding

컬렉션에 추가할 Binding 개체입니다.

반환

Binding

컬렉션에 추가된 바인딩입니다.

예외

ArgumentNullException

binding 매개 변수가 null인 경우

설명

바인딩 요소가 개체에 BindingCollection 추가되고 메서드로 Update 업데이트되면 ApplicationHost.config 파일에 저장됩니다.

바인딩이 추가되고 ApplicationHost.config 파일이 업데이트되면 IIS 관리자가 사이트 바인딩 대화 상자에 새 바인딩을 표시합니다.

Add(String, String)

지정된 프로토콜 및 바인딩 정보가 포함된 바인딩을 바인딩 컬렉션에 추가합니다.

public:
 Microsoft::Web::Administration::Binding ^ Add(System::String ^ bindingInformation, System::String ^ bindingProtocol);

public Microsoft.Web.Administration.Binding Add (string bindingInformation, string bindingProtocol);

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

Public Function Add (bindingInformation As String, bindingProtocol As String) As Binding

매개 변수

bindingInformation

String

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

bindingProtocol

String

사이트 바인딩에서 사용하는 프로토콜입니다. 매개 변수는 bindingProtocol "http" 또는 "https"여야 합니다.

반환

Binding

컬렉션에 추가된 바인딩입니다.

설명

매개 변수에는 bindingInformation 세 개의 콜론으로 구분된 필드가 있습니다. 첫 번째 필드는 특정 IP 주소 또는 별표입니다(별표는 할당되지 않은 모든 IP 주소를 지정). 두 번째 필드는 포트 번호입니다. 기본값은 80입니다. 세 번째 필드는 선택적 호스트 헤더입니다.

이미 존재하는 바인딩을 추가하려고 하면 오류가 발생합니다.

바인딩 요소가 개체에 BindingCollection 추가되고 메서드로 Update 업데이트되면 ApplicationHost.config 파일에 저장됩니다.

바인딩이 추가되고 ApplicationHost.config 파일이 업데이트되면 IIS 관리자가 사이트 바인딩 대화 상자에 새 바인딩을 표시합니다.

Add(String, Byte[], String)

바인딩 컬렉션에 보안 바인딩을 추가합니다.

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

public Microsoft.Web.Administration.Binding Add (string bindingInformation, byte[] certificateHash, string certificateStoreName);

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

Public Function Add (bindingInformation As String, certificateHash As Byte(), certificateStoreName As String) As Binding

매개 변수

bindingInformation

String

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

certificateHash

Byte[]

SSL(Secure Sockets Layer) 바인딩에 대한 인증서 해시입니다. 인증서 해시는 인증서의 고유 식별자입니다.

certificateStoreName

String

SSL 바인딩에 대한 인증서 저장소의 이름입니다.

반환

Binding

컬렉션에 추가된 바인딩입니다.

예제

다음 예제에서는 "https" 프로토콜을 사용하는 기존 사이트 바인딩에서 유효한 인증서 해시 및 인증서 저장소 이름을 검색합니다. 그런 다음, "*:448:TestingSite"의 바인딩 정보를 지정하여 검색된 인증서 해시 및 인증서 저장소를 사용하여 바인딩 컬렉션에 바인딩을 추가합니다. 마지막으로 ApplicationHost.config 파일을 업데이트하고 새로 정의된 바인딩이 사이트 바인딩 대화 상자에 나타납니다. 바인딩이 이미 있는 경우 바인딩이 삭제되므로 사용자가 바인딩 추가 및 삭제 간에 전환할 수 있습니다. 이 예제는 [Add 메서드(String, Byte<xref:Microsoft.Web.Administration.BindingCollection> 클래스)에 제공되는 더 큰 예제의 일부입니다.

// Adding a duplicate binding throws an error.
if (siteToModify != null)
{
    newbindinginformation = "*:448:TestingSite";
    try
    {
        // Add this binding. It does not already exist. 
        siteToModify.Bindings.Add(newbindinginformation, newcertificateHash, newcertificateStoreName);
    }
    catch
    {
        // Remove this binding. It already exists.
        foreach (Microsoft.Web.Administration.Binding binding in siteToModify.Bindings)
        {
            if (binding.BindingInformation == newbindinginformation)
            {
                bindingIndex = siteToModify.Bindings.IndexOf(binding);
            }
        }
        if (bindingIndex != -1)
        {
            siteToModify.Bindings.RemoveAt(bindingIndex);
        }
    }
    // Update information and save in Administration.config file.
    ManagementUnit.Update();
}

설명

이 메서드는 [Add 메서드(String, Byte<xref:Microsoft.Web.Administration.Binding> 개체에 "https" 프로토콜이 있는 [Add 메서드(String, Byte<xref:Microsoft.Web.Administration.BindingCollection> 개체)를 추가합니다. 매개 변수에는 bindingInformation 세 개의 콜론으로 구분된 필드가 있습니다. 첫 번째 필드는 특정 IP 주소 또는 별표입니다(별표는 할당되지 않은 모든 IP 주소를 지정). 두 번째 필드는 포트 번호입니다. 기본값은 80입니다. 세 번째 필드는 선택적 호스트 헤더입니다.

이미 존재하는 바인딩을 추가하려고 하면 오류가 발생합니다.

바인딩 요소가 [Add 메서드(String, Byte<xref:Microsoft.Web.Administration.BindingCollection> 개체)에 추가되고 [Add 메서드(String, Byte<xref:Microsoft.Web.Management.Server.ManagementUnit.Update%2A> 메서드)로 업데이트되면 ApplicationHost.config 파일에 저장됩니다.

바인딩이 추가되고 ApplicationHost.config 파일이 업데이트되면 IIS 관리자가 사이트 바인딩 대화 상자에 새 바인딩을 표시합니다.

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

public:
 Microsoft::Web::Administration::Binding ^ Add(System::String ^ bindingInformation, cli::array <System::Byte> ^ certificateHash, System::String ^ certificateStoreName, Microsoft::Web::Administration::SslFlags sslFlags);

public Microsoft.Web.Administration.Binding Add (string bindingInformation, byte[] certificateHash, string certificateStoreName, Microsoft.Web.Administration.SslFlags sslFlags);

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

매개 변수

bindingInformation

String

certificateHash

Byte[]

certificateStoreName

String

sslFlags

SslFlags

반환

Binding