BaseAddressPrefixFilterElement Класс

Определение

Пространство имен:: System.ServiceModel.Configuration

Сборка:: System.ServiceModel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет элемент конфигурации, указывающий сквозной фильтр, который предоставляет механизм выбора соответствующих привязок IIS при размещении приложения Windows Communication Foundation (WCF) в IIS. Этот класс не наследуется.

public ref class BaseAddressPrefixFilterElement sealed : System::Configuration::ConfigurationElement

public sealed class BaseAddressPrefixFilterElement : System.Configuration.ConfigurationElement

type BaseAddressPrefixFilterElement = class
    inherit ConfigurationElement

Public NotInheritable Class BaseAddressPrefixFilterElement
Inherits ConfigurationElement

Наследование: Object

ConfigurationElement
BaseAddressPrefixFilterElement

Поставщик фильтра префикса механизм привязки службы к конкретному URI. Он позволяет размещать несколько приложений с разными базовыми адресами для одной схемы на одном сайте.

Веб-сайты IIS — это контейнеры для виртуальных приложений, содержащих виртуальные каталоги. Доступ к приложению на сайте можно получить с помощью одной или нескольких привязок IIS. Привязки IIS предоставляют две части информации: протокол привязки и сведения о привязке. Протокол привязки (например, HTTP) определяет схему, по которой происходит взаимодействие, и сведения о привязке (например, IPAddress, Port, Hostheader) содержат данные, используемые для доступа к сайту.

IIS поддерживает указание нескольких привязок IIS на каждый сайт, что приводит к нескольким базовым адресам для каждой схемы. Так как служба WCF, размещенная под сайтом, разрешает привязку только к одному базовому адресу для каждой схемы, можно использовать функцию фильтра префикса, чтобы выбрать необходимый базовый адрес размещенной службы. Входящие базовые адреса, предоставленные IIS, фильтруются на основе необязательного фильтра списка префиксов.

Например, сайт может содержать следующие базовые адреса.

http://testl.fabrikam.com/Service.svc
http://test2.fabrikam.com/Service.svc

Следующий файл конфигурации можно использовать для указания фильтра префикса на уровне домена приложения.

<system.serviceModel>
  <serviceHostingEnvironment>
     <baseAddressPrefixFilters>
        <add prefix="net.tcp://test1.fabrikam.com:8000"/>
        <add prefix="http://test2.fabrikam.com:9000"/>
    </baseAddressPrefixFilters>
  </serviceHostingEnvironment>
</system.serviceModel>

В этом примере net.tcp://test1.fabrikam.com:8000 и http://test2.fabrikam.com:9000 являются единственными базовыми адресами для соответствующих схем, которые могут быть переданы.

По умолчанию, если префикс не указан, все адреса передаются через. При указании префикса будет использоваться только соответствующий базовый адрес для прохождения этой схемы.

Note

Фильтр не поддерживает подстановочные знаки. Кроме того, baseAddresses, предоставленные IIS, могут иметь адреса, привязанные к другим схемам, которые отсутствуют в списке baseAddressPrefixFilters . Эти адреса не отфильтровываются.

Конструкторы

Имя	Описание
BaseAddressPrefixFilterElement()	Инициализирует новый экземпляр класса BaseAddressPrefixFilterElement.
BaseAddressPrefixFilterElement(Uri)	Инициализирует новый экземпляр BaseAddressPrefixFilterElement класса с определенным универсальным кодом ресурса (URI).

Свойства

Имя	Описание
CurrentConfiguration	Возвращает ссылку на экземпляр верхнего уровня Configuration , представляющий иерархию конфигурации, к которой принадлежит текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
ElementInformation	ElementInformation Возвращает объект, содержащий не настраиваемую информацию и функциональные возможности ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
ElementProperty	ConfigurationElementProperty Возвращает объект, представляющий ConfigurationElement сам объект. (Унаследовано от ConfigurationElement)
EvaluationContext	Возвращает объект ContextInformation для объекта ConfigurationElement. (Унаследовано от ConfigurationElement)
HasContext	Возвращает значение, указывающее, является CurrentConfigurationли `null` свойство. (Унаследовано от ConfigurationElement)
Item[ConfigurationProperty]	Возвращает или задает свойство или атрибут этого элемента конфигурации. (Унаследовано от ConfigurationElement)
Item[String]	Возвращает или задает свойство, атрибут или дочерний элемент этого элемента конфигурации. (Унаследовано от ConfigurationElement)
LockAllAttributesExcept	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockAllElementsExcept	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockAttributes	Возвращает коллекцию заблокированных атрибутов. (Унаследовано от ConfigurationElement)
LockElements	Возвращает коллекцию заблокированных элементов. (Унаследовано от ConfigurationElement)
LockItem	Возвращает или задает значение, указывающее, заблокирован ли элемент. (Унаследовано от ConfigurationElement)
Prefix	Возвращает или задает префикс, используемый для сопоставления части базового адреса.
Properties	Возвращает коллекцию свойств. (Унаследовано от ConfigurationElement)

Методы

Имя	Описание
DeserializeElement(XmlReader, Boolean)	Считывает XML из файла конфигурации. (Унаследовано от ConfigurationElement)
Equals(Object)	Сравнивает текущий ConfigurationElement экземпляр с указанным объектом. (Унаследовано от ConfigurationElement)
GetHashCode()	Возвращает уникальное значение, представляющее текущий ConfigurationElement экземпляр. (Унаследовано от ConfigurationElement)
GetTransformedAssemblyString(String)	Возвращает преобразованную версию указанного имени сборки. (Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)	Возвращает преобразованную версию указанного имени типа. (Унаследовано от ConfigurationElement)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Init()	Задает объект исходному ConfigurationElement состоянию. (Унаследовано от ConfigurationElement)
InitializeDefault()	Используется для инициализации набора значений по умолчанию для ConfigurationElement объекта. (Унаследовано от ConfigurationElement)
IsModified()	Указывает, был ли изменен этот элемент конфигурации после последнего сохранения или загрузки при реализации в производном классе. (Унаследовано от ConfigurationElement)
IsReadOnly()	Возвращает значение, указывающее, доступен ли ConfigurationElement объект только для чтения. (Унаследовано от ConfigurationElement)
ListErrors(IList)	Добавляет ошибки недопустимого свойства в этом ConfigurationElement объекте и во все подэлементы в переданный список. (Унаследовано от ConfigurationElement)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)	Возвращает значение, указывающее, обнаружен ли неизвестный атрибут во время десериализации. (Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Возвращает значение, указывающее, обнаружен ли неизвестный элемент во время десериализации. (Унаследовано от ConfigurationElement)
OnRequiredPropertyNotFound(String)	Создает исключение, если обязательное свойство не найдено. (Унаследовано от ConfigurationElement)
PostDeserialize()	Вызывается после десериализации. (Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)	Вызывается перед сериализацией. (Унаследовано от ConfigurationElement)
Reset(ConfigurationElement)	Сбрасывает внутреннее состояние ConfigurationElement объекта, включая блокировки и коллекции свойств. (Унаследовано от ConfigurationElement)
ResetModified()	Сбрасывает значение IsModified() метода `false` на момент реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Записывает содержимое этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Записывает внешние теги этого элемента конфигурации в файл конфигурации при реализации в производном классе. (Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Задает свойству указанное значение. (Унаследовано от ConfigurationElement)
SetReadOnly()	IsReadOnly() Задает свойство для ConfigurationElement объекта и всех вложенных элементов. (Унаследовано от ConfigurationElement)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Изменяет объект для удаления всех значений ConfigurationElement , которые не должны быть сохранены. (Унаследовано от ConfigurationElement)

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?