BaseAddressPrefixFilterElement Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um elemento de configuração que especifica um filtro de passagem, que fornece um mecanismo para escolher as ligações IIS apropriadas ao hospedar uma aplicação Windows Communication Foundation (WCF) no IIS. Esta classe não pode ser herdada.
public ref class BaseAddressPrefixFilterElement sealed : System::Configuration::ConfigurationElementpublic sealed class BaseAddressPrefixFilterElement : System.Configuration.ConfigurationElementtype BaseAddressPrefixFilterElement = class
inherit ConfigurationElementPublic NotInheritable Class BaseAddressPrefixFilterElement
Inherits ConfigurationElement- Herança
Observações
Um fornecedor de filtro prefixo é um mecanismo para um serviço se ligar a um URI específico. Permite-lhe alojar várias aplicações com diferentes endereços base para o mesmo esquema no mesmo site.
Os sites IIS são contentores para aplicações virtuais que contêm diretórios virtuais. A aplicação num site pode ser acedida através de uma ou mais ligações IIS. As ligações IIS fornecem duas informações: protocolo de ligação e informação de ligação. O protocolo de ligação (por exemplo, HTTP) define o esquema sobre o qual ocorre a comunicação, e a informação de ligação (por exemplo, IPAddress, Port, Hostheader) contém dados usados para aceder ao site.
O IIS suporta a especificação de múltiplas ligações IIS por site, o que resulta em múltiplos endereços base por esquema. Como um serviço WCF alojado num site permite ligar apenas a um endereço base por esquema, pode usar a funcionalidade de filtro prefixo para escolher o endereço base necessário do serviço alojado. Os endereços base recebidos, fornecidos pelo IIS, são filtrados com base no filtro opcional da lista de prefixos.
Por exemplo, o seu site pode conter os seguintes endereços base
http://testl.fabrikam.com/Service.svc
http://test2.fabrikam.com/Service.svc
Pode usar o ficheiro de configuração seguinte para especificar um filtro de prefixo ao nível do domínio da app.
<system.serviceModel>
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
<add prefix="net.tcp://test1.fabrikam.com:8000"/>
<add prefix="http://test2.fabrikam.com:9000"/>
</baseAddressPrefixFilters>
</serviceHostingEnvironment>
</system.serviceModel>
Neste exemplo, net.tcp://test1.fabrikam.com:8000 e http://test2.fabrikam.com:9000 são os únicos endereços base para os respetivos esquemas que podem ser passados.
Por defeito, quando o prefixo não é especificado, todos os endereços são passados. Especificar o prefixo resultará apenas na passagem do endereço base correspondente para esse esquema.
Note
O filtro não suporta quaisquer curingas. Além disso, os baseAddresses fornecidos pelo IIS podem ter endereços ligados a outros esquemas não presentes na baseAddressPrefixFilters lista. Esses endereços não são filtrados.
Construtores
| Name | Description |
|---|---|
| BaseAddressPrefixFilterElement() |
Inicializa uma nova instância da BaseAddressPrefixFilterElement classe. |
| BaseAddressPrefixFilterElement(Uri) |
Inicializa uma nova instância da BaseAddressPrefixFilterElement classe com um URI específico. |
Propriedades
| Name | Description |
|---|---|
| CurrentConfiguration |
Obtém uma referência à instância de topo Configuration que representa a hierarquia de configuração a que pertence a instância atual ConfigurationElement . (Herdado de ConfigurationElement) |
| ElementInformation |
Obtém um ElementInformation objeto que contém a informação e funcionalidade não personalizáveis do ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| ElementProperty |
Obtém o ConfigurationElementProperty objeto que representa o ConfigurationElement próprio objeto. (Herdado de ConfigurationElement) |
| EvaluationContext |
Obtém o ContextInformation objeto para o ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| HasContext |
Obtém um valor que indica se a CurrentConfiguration propriedade é |
| Item[ConfigurationProperty] |
Obtém ou define uma propriedade ou atributo deste elemento de configuração. (Herdado de ConfigurationElement) |
| Item[String] |
Obtém ou define uma propriedade, atributo ou elemento filho deste elemento de configuração. (Herdado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockAllElementsExcept |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockAttributes |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockElements |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockItem |
Recebe ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement) |
| Prefix |
Recebe ou define um prefixo que é usado para corresponder a uma parte de um endereço base. |
| Properties |
Recebe a coleção de propriedades. (Herdado de ConfigurationElement) |
Métodos
| Name | Description |
|---|---|
| DeserializeElement(XmlReader, Boolean) |
Lê XML a partir do ficheiro de configuração. (Herdado de ConfigurationElement) |
| Equals(Object) |
Compara a instância atual ConfigurationElement com o objeto especificado. (Herdado de ConfigurationElement) |
| GetHashCode() |
Obtém um valor único que representa a instância atual ConfigurationElement . (Herdado de ConfigurationElement) |
| GetTransformedAssemblyString(String) |
Devolve a versão transformada do nome da assembleia especificado. (Herdado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Devolve a versão transformada do nome do tipo especificado. (Herdado de ConfigurationElement) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Init() |
Define o ConfigurationElement objeto para o seu estado inicial. (Herdado de ConfigurationElement) |
| InitializeDefault() |
Usado para inicializar um conjunto padrão de valores para o ConfigurationElement objeto. (Herdado de ConfigurationElement) |
| IsModified() |
Indica se este elemento de configuração foi modificado desde a última vez que foi guardado ou carregado, quando implementado numa classe derivada. (Herdado de ConfigurationElement) |
| IsReadOnly() |
Recebe um valor que indica se o ConfigurationElement objeto é apenas de leitura. (Herdado de ConfigurationElement) |
| ListErrors(IList) |
Adiciona os erros de propriedades inválidas neste ConfigurationElement objeto, e em todos os subelementos, à lista passada. (Herdado de ConfigurationElement) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Recebe um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtém um valor que indica se um elemento desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Lança uma exceção quando uma propriedade exigida não é encontrada. (Herdado de ConfigurationElement) |
| PostDeserialize() |
Chamada após desserialização. (Herdado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chamado antes da serialização. (Herdado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Reinicia o estado interno do ConfigurationElement objeto, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement) |
| ResetModified() |
Redefine o valor do IsModified() método para |
| SerializeElement(XmlWriter, Boolean) |
Escreve o conteúdo deste elemento de configuração no ficheiro de configuração quando implementado numa classe derivada. (Herdado de ConfigurationElement) |
| SerializeToXmlElement(XmlWriter, String) |
Escreve as etiquetas exteriores deste elemento de configuração no ficheiro de configuração quando implementado numa classe derivada. (Herdado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Define uma propriedade para o valor especificado. (Herdado de ConfigurationElement) |
| SetReadOnly() |
Define a IsReadOnly() propriedade para o ConfigurationElement objeto e todos os subelementos. (Herdado de ConfigurationElement) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica o ConfigurationElement objeto para remover todos os valores que não deveriam ser guardados. (Herdado de ConfigurationElement) |
