BindingCollection.Add Метод

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

Параметры

Возвращаемое значение

Привязка, добавленная в коллекцию.

Исключения

Комментарии

Когда элемент привязки добавляется в BindingCollection объект и обновляется с помощью Update метода , он сохраняется в файле ApplicationHost.config.

После добавления привязки и обновления файла ApplicationHost.config диспетчер СЛУЖБ IIS отобразит новую привязку в диалоговом окне Привязки сайта .

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 содержит три поля с разделителями двоеточием. Первое поле — это конкретный IP-адрес или звездочка (звездочка указывает все неназначенные IP-адреса). Второе поле — номер порта; Значение по умолчанию — 80. Третье поле является необязательным заголовком узла.

Попытка добавить уже существующую привязку вызовет ошибку.

Когда элемент привязки добавляется в BindingCollection объект и обновляется с помощью Update метода , он сохраняется в файле ApplicationHost.config.

После добавления привязки и обновления файла ApplicationHost.config диспетчер СЛУЖБ IIS отобразит новую привязку в диалоговом окне Привязки сайта .

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

Параметры

Возвращаемое значение

Привязка, добавленная в коллекцию.

Примеры

В следующем примере извлекается допустимый хэш сертификата и имя хранилища сертификатов из существующей привязки сайта, использующего протокол https. Затем в примере добавляется привязка в коллекцию привязки с извлеченным хэшом сертификата и хранилищем сертификатов, указывая сведения о привязке "*:448:TestingSite". Наконец, в примере обновляется файл ApplicationHost.config, и только что определенная привязка появится в диалоговом окне Привязки сайта . Если привязка уже существует, привязка удаляется, что позволяет пользователю переключаться между добавлением и удалением привязки. Этот пример является частью более крупного примера, предоставленного для класса [Add Method (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 Method (String, Byte<xref:Microsoft.Web.Administration.Binding> с протоколом https" к объекту [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> ). Параметр bindingInformation содержит три поля с разделителями двоеточием. Первое поле — это конкретный IP-адрес или звездочка (звездочка указывает все неназначенные IP-адреса). Второе поле — номер порта; Значение по умолчанию — 80. Третье поле является необязательным заголовком узла.

Попытка добавить уже существующую привязку вызовет ошибку.

Когда элемент привязки добавляется в объект [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> и обновляется методом [Add Method (String, Byte<xref:Microsoft.Web.Management.Server.ManagementUnit.Update%2A> ), он сохраняется в ApplicationHost.config файле.

После добавления привязки и обновления файла ApplicationHost.config диспетчер СЛУЖБ IIS отобразит новую привязку в диалоговом окне Привязки сайта .

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

Параметры

Возвращаемое значение