BindingCollection.Add Método

Referência

Definição

Namespace:: Microsoft.Web.Administration

Assembly:: Microsoft.Web.Administration.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona uma associação HTTP ou HTTPS à coleção de associação.

Sobrecargas

Add(Binding)	Adiciona uma associação segura ao final da coleção.
Add(String, String)	Adiciona uma associação com o protocolo especificado e informações de associação à coleção de associação.
Add(String, Byte[], String)	Adiciona uma associação segura à coleção de associação.
Add(String, Byte[], String, SslFlags)

Add(Binding)

Adiciona uma associação segura ao final da coleção.

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

Parâmetros

binding: Binding

O objeto Binding a ser adicionado à coleção.

Retornos

Binding

A associação que foi adicionada à coleção.

Exceções

ArgumentNullException

O parâmetro binding é null.

Comentários

Quando um elemento de associação é adicionado ao BindingCollection objeto e atualizado com o Update método , ele é armazenado no arquivo ApplicationHost.config.

Depois que uma associação tiver sido adicionada e o arquivo ApplicationHost.config tiver sido atualizado, o Gerenciador do IIS mostrará a nova associação na caixa de diálogo Associações de Site .

Aplica-se a

Add(String, String)

Adiciona uma associação com o protocolo especificado e informações de associação à coleção de associação.

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

Parâmetros

bindingInformation: String

As informações de associação de um site.

bindingProtocol: String

O protocolo usado pela associação de site. O bindingProtocol parâmetro deve ser "http" ou "https".

Retornos

Binding

A associação que foi adicionada à coleção.

Comentários

O bindingInformation parâmetro tem três campos delimitados por dois-pontos. O primeiro campo é um endereço IP específico ou um asterisco (um asterisco especifica todos os endereços IP não atribuídos). O segundo campo é o número da porta; o padrão é 80. O terceiro campo é um cabeçalho de host opcional.

Uma tentativa de adicionar uma associação que já existe gerará um erro.

Quando um elemento de associação é adicionado ao BindingCollection objeto e atualizado com o Update método , ele é armazenado no arquivo ApplicationHost.config.

Aplica-se a

Add(String, Byte[], String)

Adiciona uma associação segura à coleção de associação.

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

Parâmetros

bindingInformation: String

As informações de associação de um site.

certificateHash: Byte[]

O hash de certificado para a associação SSL (Secure Sockets Layer). O hash do certificado é o identificador exclusivo do certificado.

certificateStoreName: String

O nome do repositório de certificados para a associação SSL.

Retornos

Binding

A associação que foi adicionada à coleção.

Exemplos

O exemplo a seguir recupera um hash de certificado válido e o nome do repositório de certificados de uma associação de site existente que usa o protocolo "https". Em seguida, o exemplo adiciona uma associação à coleção de associação com o hash de certificado recuperado e o repositório de certificados, especificando informações de associação de "*:448:TestingSite". Por fim, o exemplo atualiza o arquivo ApplicationHost.config e a associação recém-definida aparece na caixa de diálogo Associações de Site . Se a associação já existir, a associação será excluída, permitindo que o usuário alterne entre adicionar e excluir a associação. Este exemplo faz parte de um exemplo maior fornecido para a classe [Método 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();
}

Comentários

Esse método adiciona um objeto [Add Method (String, Byte<xref:Microsoft.Web.Administration.Binding> com o protocolo "https" ao objeto [Add Method (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> ). O bindingInformation parâmetro tem três campos delimitados por dois-pontos. O primeiro campo é um endereço IP específico ou um asterisco (um asterisco especifica todos os endereços IP não atribuídos). O segundo campo é o número da porta; o padrão é 80. O terceiro campo é um cabeçalho de host opcional.

Uma tentativa de adicionar uma associação que já existe gerará um erro.

Quando um elemento de associação é adicionado ao objeto [Método Add (String, Byte<xref:Microsoft.Web.Administration.BindingCollection> e atualizado com o método [Add Method(String, Byte<xref:Microsoft.Web.Management.Server.ManagementUnit.Update%2A> ), ele é armazenado no arquivo ApplicationHost.config.

Aplica-se a

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

Parâmetros

bindingInformation: String

certificateHash: Byte[]

certificateStoreName: String

sslFlags: SslFlags

Retornos

Binding

Aplica-se a

Compartilhar via

BindingCollection.Add Método

Definição

Sobrecargas

Add(Binding)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Add(String, String)

Parâmetros

Retornos

Comentários

Aplica-se a

Add(String, Byte[], String)

Parâmetros

Retornos

Exemplos

Comentários

Aplica-se a

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

Parâmetros

Retornos

Aplica-se a

Recursos adicionais