Поделиться через

Справочник по конфигурации модуля переопределения URL-адресов

  • Статья

Руслан Якушев

В этой статье представлен обзор модуля перезаписи URL-адресов и описаны основные понятия конфигурации, используемые модулем.

Общие сведения о функциях

Модуль перезаписи URL-адресов изменяет URL-адреса запросов на простые, удобные для пользователя и поисковых систем адреса, которые отображаются пользователям или в веб-приложениях. Переопределение URL-адресов использует определенные правила для оценки и сопоставления URL-адреса запроса с адресом, определенным в правиле, прежде чем он обрабатывается веб-сервером IIS. Вы можете определить логику перезаписи URL-адресов, включающую регулярные выражения и подстановочные знаки, и правила можно применять на основе URL-адреса запроса, заголовков HTTP и переменных сервера. Хотя основной целью модуля является перезапись URL-адресов запросов на более понятные URL-адреса, вы также можете использовать модуль для определения правил, выполняющих перенаправления, отправки пользовательских ответов или прерывания запросов.

Обзор правил перезаписи

Правило переопределения определяет логику того, с чем сравнивать или сопоставлять URL-адрес запроса, и что делать в случае успешного сравнения.

Правила перезаписи состоят из следующих частей:

  • Шаблон — шаблон правила используется для указания регулярного выражения или шаблона подстановочного знака, используемого для сопоставления строк URL-адресов.
  • Условия — коллекция необязательных условий используется для указания дополнительных логических операций для выполнения, если строка URL-адреса соответствует шаблону правила. В условиях можно проверить определенные значения заголовков HTTP или переменных сервера или проверить, соответствует ли запрошенный URL-адрес файлу или каталогу в физической файловой системе.
  • Действие — действие используется для указания того, что делать, если строка URL-адреса соответствует шаблону правила и выполняются все условия правила.

Область правил переписывания

Правила перезаписи можно определить в двух разных коллекциях:

  • <globalRules> — Правила в этой коллекции можно определить только на уровне сервера. Глобальные правила используются для определения логики перезаписи URL-адресов на уровне сервера. Эти правила определены в файле ApplicationHost.config, и они не могут быть переопределены или отключены на всех более низких уровнях конфигурации. Глобальные правила всегда применяются к пути абсолютного URL-адреса (т.е. к URI запроса без имени сервера). Эти правила оцениваются в начале конвейера обработки запросов IIS (событие PreBeginRequest ).
  • <rules> — правила в этой коллекции называются распределенными правилами, и их можно определить на любом уровне в иерархии конфигурации. Распределенные правила используются для определения логики изменения URL-адресов в рамках определенной области конфигурации. Этот тип правила можно добавить на любом уровне конфигурации с помощью файлов Web.config или с помощью <location> тегов в ApplicationHost.config или Web.config файлах. Распределенные правила действуют по URL-пути, относительно расположения файла Web.config, где они определены. В случаях, когда распределенные правила определяются внутри тега <location> , они работают по URL-пути относительно пути, указанному для этого <location> тега. Эти правила оцениваются на событии BeginRequest в конвейере IIS.

Оценка правил

Каждый уровень конфигурации в IIS может иметь ноль или больше правил перезаписи. Правила оцениваются в том же порядке, в котором они указаны. Модуль переопределения URL-адресов обрабатывает набор правил с помощью следующего алгоритма:

  1. Во-первых, URL-адрес соответствует шаблону правила. Если он не соответствует, модуль перезаписи URL-адресов немедленно останавливает обработку этого правила и переходит к следующему правилу.
  2. Если шаблон совпадает и нет условий для правила, модуль перезаписи URL-адресов выполняет действие, указанное для этого правила, а затем переходит к следующему правилу, где он использует замененный URL-адрес в качестве входных данных для этого правила.
  3. Если шаблон соответствует правилу и есть условия, модуль перезаписи URL-адресов оценивает условия. Если оценка выполнена успешно, выполняется указанное действие правила, и затем URL-адрес после перезаписи используется в качестве входных данных для последующего правила.

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

Наследование правил

Если правила определены на нескольких уровнях конфигурации, модуль перезаписи URL-адресов оценивает правила в следующем порядке:

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

Сохранение исходного URL-адреса

Модуль переопределения URL-адресов сохраняет исходный запрошенный путь URL-адреса в следующих переменных сервера:

  • HTTP_X_ORIGINAL_URL — эта переменная сервера содержит исходный URL-адрес в декодируемом формате;
  • UNENCODED_URL — эта переменная сервера содержит исходный URL-адрес точно так же, как он был запрошен веб-клиентом, при сохранении всех исходных кодировок.

Доступ к частям URL-адреса из правила переопределения

Важно понимать, как к определенным частям строки URL-адреса можно получить доступ из правила перезаписи.

Для URL-адреса HTTP в этой форме: http(s)://<host>:<port>/<path>?<querystring>

  • <Путь> сравнивается с шаблоном правила.
  • Строка <запросов> доступна в переменной сервера, называемой QUERY_STRING, и к ней можно получить доступ с помощью условия в правиле.
  • Хост <> доступен в переменной сервера HTTP_HOST и может быть доступен через использование условия в правиле.
  • Порт <> доступен в переменной сервера SERVER_PORT и может быть доступен с помощью условия в правиле.
  • Переменные сервера SERVER_PORT_SECURE и HTTPS можно использовать для определения того, использовалось ли безопасное подключение. Доступ к этим переменным сервера можно получить с помощью условия в правиле.
  • Переменная сервера REQUEST_URI может использоваться для доступа ко всему запрошенным URL-пути, включая строку запроса.

Например, если запрос был выполнен для этого URL-адреса: http://www.mysite.com/content/default.aspx?tabid=2&subtabid=3и на уровне сайта определено правило перезаписи:

  • Шаблон правила получает строку content/default.aspx URL-адреса в качестве входных данных.
  • Переменная сервера QUERY_STRING содержит tabid=2&subtabid=3.
  • Переменная сервера HTTP_HOST содержит www.mysite.com.
  • Переменная сервера SERVER_PORT содержит 80.
  • Переменная сервера SERVER_PORT_SECURE содержит 0, а HTTPS содержит OFF.
  • Переменная сервера REQUEST_URI содержит /content/default.aspx?tabid=2&subtabid=3.
  • Переменная сервера PATH_INFO содержит /content/default.aspx.

Обратите внимание, что входная строка URL-адреса, передаваемая в распределенное правило, всегда соответствует расположению файла Web.config, в котором определено правило. Например, если выполняется запрос на http://www.mysite.com/content/default.aspx?tabid=2&subtabid=3, и правило перезаписи определяется в каталоге /content, то это правило получает URL-строку default.aspx в качестве входных данных.

Переопределение конфигурации правила

Шаблон правила

Шаблон правила перезаписи используется для указания шаблона, с которым сравнивается текущий путь URL-адреса. Текущее значение в этом контексте означает значение пути URL-адреса при применении правила. Если перед текущим правилом существовали какие-либо правила, возможно, они соответствовали исходному запрошенному URL-адресу и изменили его. Строка URL-адреса, вычисляемая по шаблону, не включает строку запроса. Чтобы включить строку запроса в оценку правила, можно использовать переменную сервера QUERY_STRING в условии правила. Дополнительные сведения см. в разделе "Использование переменных сервера в правилах перезаписи".

Шаблон указывается в элементе <match> правила преобразования.

Синтаксис шаблона правила

Синтаксис шаблона правила можно указать с помощью атрибута patternSyntax правила. Этот атрибут можно задать для одного из следующих параметров:

ECMAScript — синтаксис регулярного выражения, совместимый с Perl (стандарт ECMAScript). Это параметр по умолчанию для любого правила. Это пример формата шаблона: "^([_0-9a-zA-Z-]+/)?(wp-.*)"

Подстановочный знак — используемый в модуле перенаправления HTTP IIS. Ниже приведен пример шаблона в этом формате: "/Scripts/*_in.???", где звездочка ("*") означает "соответствовать любому количеству символов и записывать их в обратной ссылке" и "?" означает, что соответствует ровно одному символу (обратная ссылка не создается).

Область действия атрибута patternSyntax является правилом, то есть применяется к шаблону текущего правила и ко всем шаблонам, используемым в условиях этого правила.

Свойства шаблона правила

Шаблон можно отрицать с помощью атрибута <negate элемента match>. Если этот атрибут используется, действие правила выполняется только в том случае, если текущий URL-адрес не соответствует указанному шаблону.

По умолчанию используется сопоставление шаблонов без учета регистра. Чтобы включить конфиденциальность регистра, можно использовать атрибут <ignoreCase элемента сопоставления> правила.

Условия правил

Условия правила позволяют определять дополнительную логику для оценки правил, которая может быть основана на входных данных, отличных от текущей строки URL-адреса. Любое правило может иметь ноль или более условий. Условия правила оцениваются после успешного сопоставления шаблона правила.

Условия определяются в <коллекции условий> правила переопределения. Эта коллекция имеет атрибут, называемый логическим группированием , который определяет, как оцениваются условия. Если правило имеет условия, действие правила выполняется только в том случае, если шаблон правила соответствует и:

  • Все условия считались истинными, если использовалось логическое группирование="MatchAll".
  • По крайней мере одно из условий было оценено как истина, при условии, что использовалось logicalGrouping="MatchAny".

Условие определяется путем указания следующих свойств:

  • Входная строка
  • Тип сопоставления

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

Тип соответствия может быть одним из этих трех вариантов:

  • IsFile — этот тип соответствия используется для определения того, содержит ли входная строка физический путь к файлу в файловой системе. Если строка ввода условия не указана, модуль перезаписи URL-адресов использует физический путь запрошенного файла в качестве значения по умолчанию для входных данных условия. Этот тип соответствия можно использовать только для распределенных правил.

  • IsDirectory — этот тип сопоставления используется для определения того, содержит ли входная строка физический путь к каталогу в файловой системе. Если строка ввода условия не указана, модуль перезаписи URL-адресов использует физический путь запрошенного файла в качестве значения по умолчанию для входных данных условия. Этот тип соответствия можно использовать только для распределенных правил.

  • Шаблон — этот тип сопоставления используется для выражения условия, в котором произвольные входные строки сопоставляются с шаблоном регулярного выражения. Шаблон условия можно указать с помощью синтаксиса регулярного выражения или с помощью синтаксиса подстановочных знаков. Тип шаблона, используемый в условии, зависит от значения флага patternSyntax , определенного для правила, к которому принадлежит это условие. Этот тип условия имеет два связанных атрибута, которые управляют сопоставлением шаблонов:

    • шаблон — используйте этот атрибут для указания фактического шаблона.
    • ignoreCase — используйте этот атрибут, чтобы управлять, должно ли сопоставление шаблонов учитывать регистр или нет.

Кроме того, результат оценки условия можно отрицать с помощью атрибута negate . Это можно использовать для указания условия, которое проверяет, является ли запрошенный URL-адрес не файлом, как показано в следующем примере:

<add input="{REQUEST_FILENAME}" matchType="isFile" negate="true">

Действие правила

Действие перезаписи правила выполняется, когда текущий URL-адрес соответствует шаблону правила и успешно выполнена оценка условия (в зависимости от конфигурации правила все условия соответствуют или одному или нескольким условиям). Доступно несколько типов действий, а атрибут <типа элемента конфигурации действия> можно использовать для указания действия, выполняемого правилом. В следующих разделах описаны различные типы действий и параметры конфигурации, связанные с конкретными типами действий.

Действие перезаписи

Действие перезаписи заменяет текущую строку URL-адреса строкой подстановки. Строка подстановки всегда должна указывать путь URL-адреса (например, contoso/test/default.aspx). Обратите внимание, что подстановки, содержащие физический путь в файловой системе (например, C:\inetpub\wwwroot), не поддерживаются в службах IIS.

Действие перезаписи имеет следующие параметры конфигурации:

  • URL-адрес — это строка подстановки, используемая при перезаписи текущего URL-адреса. URL-адрес подстановки — это строковое значение, которое может содержать следующее:

    • Обратные ссылки на шаблоны условий и правил. (Дополнительные сведения см. в разделе об использовании обратных ссылок.)
    • Переменные сервера. (Дополнительные сведения см. в разделе об использовании переменных сервера.)

  • appendQueryString — указывает, сохраняется ли строка запроса из текущего URL-адреса во время подстановки. По умолчанию, если значение флага appendQueryString не указано, предполагается, что значение равно TRUE. Это означает, что строка запроса из исходного URL-адреса добавляется к заменяемом URL-адресу.

Действие перенаправления

Действие перенаправления указывает модулю переадресации URL отправить перенаправляющий ответ клиенту. Код состояния перенаправления (3xx) можно указать в качестве параметра для этого действия. Поле "Расположение " ответа содержит строку подстановки, указанную в правиле.

URL-адрес подстановки правила перенаправления можно указать в одной из следующих форм:

  • Относительный URL-путь — contoso/test/default.aspx
  • Абсолютный универсальный код ресурса (URI) — https://example.com/contoso/test/default.aspx

Использование действия перенаправления подразумевает, что после выполнения перенаправления последующие правила для текущего URL-адреса не оцениваются.

Действие перенаправления имеет следующие параметры конфигурации:

  • URL - использует строку подстановки в качестве URL-адреса перенаправления. URL-адрес подстановки — это строка, которая может содержать следующее:

    • Обратные ссылки на шаблоны условий и правил. (Дополнительные сведения см. в разделе об использовании обратных ссылок.)
    • Переменные сервера. (Дополнительные сведения см. в разделе об использовании переменных сервера.)

  • appendQueryString — указывает, должна ли строка запроса из текущего URL-адреса сохраняться во время подстановки. По умолчанию, если флаг AppendQueryString не указан, предполагается, что он имеет значение TRUE. Это означает, что строка запроса из исходного URL-адреса добавляется к заменяемом URL-адресу.

  • redirectType — задает код состояния, используемый во время перенаправления:

    • 301 — постоянный
    • 302 — найдено
    • 303 — см. другие
    • 307 — временная

    Примечание.

    Код состояния HTTP 308 (постоянное перенаправление) не поддерживается модулем перезаписи URL-адресов.

Действие типа CustomResponse

Действие CustomResponse приводит к тому, что модуль переопределения URL-адресов отвечает на HTTP-клиент с помощью указанного пользователем кода состояния, подкода и причины. Использование действия CustomResponse подразумевает, что последующие правила не вычисляются для текущего URL-адреса после выполнения этого действия.

Действие CustomResponse имеет следующие параметры конфигурации:

  • statusCode— указывает код состояния, который используется в ответе клиенту.
  • subStatusCode — указывает код подстатуса, используемый в ответ клиенту.
  • statusReason — указывает фразу причины, используемую с кодом состояния.
  • statusDescription — указывает одно описание строки, которое нужно поместить в текст ответа.

Действие AbortRequest

Действие AbortRequest приводит к тому, что модуль перезаписи URL-адресов удаляет HTTP-подключение для текущего запроса. Действие не имеет параметров. Использование этого действия подразумевает, что последующие правила не оцениваются для текущего URL-адреса после выполнения этого действия.

Нет действия

Действие None используется для указания того, что действие не выполняется.

Использование переменных сервера в правилах перезаписи

Переменные сервера предоставляют дополнительные сведения о текущих HTTP-запросах. Эту информацию можно использовать для принятия решений о редактировании или составления изменённого URL-адреса. На переменные сервера можно ссылаться в следующих расположениях в правилах переопределения:

  • В строке ввода условия

  • В строках подстановки правил, в частности:

    • Атрибут url-адреса действия перезаписи и перенаправления
    • statusLine и responseLine действия CustomResponse

На переменные сервера можно ссылаться с помощью синтаксиса {VARIABLE_NAME}. Например, следующее условие использует переменную сервера QUERY_STRING:

<add input="{QUERY_STRING}" pattern="id=([0-9]+)" />

Переменные сервера также можно использовать для доступа к заголовкам HTTP в текущем запросе. Любой заголовок HTTP, предоставленный текущим запросом, представляется в виде переменной сервера, которая имеет имя, созданное в соответствии с этим соглашением об именовании:

  1. Все символы дефиса ("-") в имени заголовка HTTP преобразуются в символы подчеркивания ("_").
  2. Все буквы в имени заголовка HTTP преобразуются в верхний регистр.
  3. Префикс "HTTP_" добавляется в имя заголовка.

Например, чтобы получить доступ к заголовку HTTP "user-agent" из правила перезаписи, можно использовать переменную сервера {HTTP_USER_AGENT}.

Использование обратных ссылок в правилах перезаписи

Части входных данных правил или условий могут быть записаны в обратных ссылках. Затем их можно использовать для создания URL-адресов замены в действиях правил или для создания входных строк для этих условий правила.

Обратные ссылки создаются различными способами в зависимости от типа синтаксиса шаблона, используемого для правила. При использовании синтаксиса шаблона ECMAScript можно создать обратную ссылку, поместив скобки вокруг части шаблона, которая должна записывать обратную ссылку. Например, шаблон ([0-9]+)/([a-z]+.html) будет записывать 07 и статью в обратной ссылке из этого запрошенного URL-адреса: 07/article.html. При использовании синтаксиса шаблона "Подстановочный знак", обратные ссылки всегда создаются, когда в шаблоне используется символ звездочки (*). При использовании символа "?" в шаблоне не создаются обратные ссылки. Например, шаблон */*.html будет записывать contoso и тестировать обратные ссылки из этого запрошенного URL-адреса: contoso/test.html.

Использование обратных ссылок одинаково независимо от того, какой синтаксис шаблона использовался для их записи. Обратные ссылки можно использовать в следующих расположениях в правилах перезаписи:

  • Во вводимых строках условий

  • В частности, в действиях правил:

    • Атрибут url-адреса действия перезаписи и перенаправления
    • statusLine и responseLine действия CustomResponse

  • В ключевом параметре для карты перезаписи

Обратные ссылки на шаблоны условий определяются {C:N}, где N составляет от 0 до 9. Обратные ссылки на шаблоны правил определяются {R:N}, где N — от 0 до 9. Обратите внимание, что для обоих типов обратных ссылок {R:0} и {C:0}будут содержать соответствующую строку.

Например, в этом шаблоне:

^(www\.)(.*)$

Для строки: www.foo.com обратные ссылки будут индексированы следующим образом:

{C:0} - www.foo.com
{C:1} - www.
{C:2} - foo.com

В действии правила можно использовать обратные ссылки на шаблон правила и последнее соответствующее условие этого правила. В строке ввода условия можно использовать обратные ссылки на шаблон правила и ранее соответствующее условие.

В следующем примере правила показано, как создаются и ссылаются обратные ссылки:

<rule name="Rewrite subdomain">
 <match url="^(.+)" /> <!-- rule back-reference is captured here -->
 <conditions>
  <add input="{HTTP_HOST}" type="Pattern" pattern="^([^.]+)\.mysite\.com$" /> <!-- condition back-reference is captured here -->
 </conditions>
 <action type="Rewrite" url="{C:1}/{R:1}" /> <!-- rewrite action uses back-references to condition and to rule when rewriting the url -->
</rule>

Взаимодействие с кэшированием выходных данных IIS

Модуль переопределения URL-адресов управляет поведением кэша выходных данных IIS, чтобы:

  1. Оптимально использовать режим ядра и кэширование выходных данных в пользовательском режиме для перезаписи URL-адресов, что повышает производительность веб-приложения, использующего модуль переопределения URL-адресов.
  2. Предотвращение кэширования ответов при нарушении логики кэширования из-за перезаписи URL-адресов.

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

  1. Модуль всегда задает настройку кэша в пользовательском режиме varyByHeader="HTTP_X_ORIGINAL_URL". Это гарантирует, что при включении кэширования в пользовательском режиме модуль учитывает исходный URL-адрес для создания ключа для записи кэша.

  2. Если набор правил перезаписи использует переменные сервера со значениями, которые являются либо константой в течение всего процесса, либо производными от запрошенного URL-адреса, набор правил считается безопасным для кэширования выходных данных. Это означает, что модуль перезаписи URL-адресов не будет изменять существующую политику кэширования, отличной от параметра varyByHeader , как описано на шаге 1.

    Следующие переменные сервера при использовании в правилах перезаписи не вызывают никакого влияния на политику кэширования выходных данных:

    • "CACHE_URL"
    • "DOCUMENT_ROOT"
    • HTTP_URL
    • HTTP_HOST
    • "PATH_INFO"
    • "ПУТЬ_ПЕРЕВОДА"
    • "QUERY_STRING"
    • "REQUEST_FILENAME"
    • "REQUEST_URI"
    • "SCRIPT_FILENAME"
    • "SCRIPT_NAME"
    • СЦЕНАРИЙ_ПЕРЕВЕДЕН
    • "UNENCODED_URL"
    • URL-адрес
    • "URL_PATH_INFO"
    • ""APP_POOL_ID"
    • "APPL_MD_PATH"
    • "APPL_PHYSICAL_PATH"
    • "GATEWAY_INTERFACE"
    • СЕРВЕРНОЕ_ПРОГРАММНОЕ_ОБЕСПЕЧЕНИЕ
    • "SSI_EXEC_DISABLED"

  3. Если набор правил перезаписи использует любую переменную сервера, не указанную в приведенном выше списке, набор правил считается небезопасным для кэширования выходных данных. Это означает, что модуль перезаписи URL-адресов будет отключать кэширование в режиме ядра для всех запросов, независимо от того, были перезаписаны URL-адреса или нет. Кроме того, модуль изменит политику кэширования для кэша пользовательского режима, задав свойство кэширования varyByValue , чтобы содержать сцепленную строку всех значений переменных сервера, используемых в наборе правил.

Строковые функции

Существует три строковые функции, доступные для изменения значений в действии правила переопределения, а также для любых условий:

  • ToLower — возвращает входную строку, преобразованную в нижний регистр.
  • UrlEncode — возвращает входную строку, преобразованную в формат, закодированный URL-адресом. Эту функцию можно использовать, если URL-адрес подстановки в правиле перезаписи содержит специальные символы (например, не-ASCII или URI-небезопасные символы).
  • UrlDecode — декодирует входную строку, закодированную в URL-адресе. Эту функцию можно использовать для декодирования входных данных условия перед сопоставлением с шаблоном.

Функции можно вызвать с помощью следующего синтаксиса:

{function_name:any_string}

Где "function_name" может быть одним из следующих: ToLower, UrlEncode, UrlDecode. "Any_string" может быть литеральной строкой или строкой, созданной с помощью переменных сервера или обратных ссылок. Например, ниже приведены допустимые вызовы строковых функций:

{ToLower:DEFAULT.HTM}
{UrlDecode:{REQUEST_URI}}
{UrlEncode:{R:1}.aspx?p=[résumé]}

Строковые функции можно использовать в следующих местах в правилах перезаписи:

  • Во входных строках условий

  • В строках замены правил, в частности:

    • Атрибут URL-адреса действий перезаписи и перенаправления
    • Атрибуты statusLine и responseLine действия CustomResponse

Пример правила, использующего функцию ToLower :

<rule name="Redirect to canonical url">
 <match url="^(.+)" /> <!-- rule back-reference is captured here -->
 <conditions>
  <!-- Check whether the requested domain is in canonical form -->
  <add input="{HTTP_HOST}" type="Pattern" pattern="^www\.mysite\.com$" negate="true" /> 
 </conditions>
 <!-- Redirect to canonical url and convert URL path to lowercase -->
 <action type="Redirect" url="http://www.mysite.com/{ToLower:{R:1}}" redirectType="Found" />
</rule>

Пример правила, использующего функцию UrlEncode :

<rules>
   <rule name="UrlEncode example" stopProcessing="true">
   <match url="resume" />
   <action type="Rewrite" url="default.aspx?name={UrlEncode:résumé}"/>
</rule>

Пример правила, использующего функцию UrlDecode :

<rules>
   <rule name="UrlDecode example">
      <match url="default.aspx" />
      <conditions>
         <add input="{UrlDecode:{QUERY_STRING}}" pattern="résumé" />
      </conditions>
      <action type="Rewrite" url="default.aspx?type=resume" />
   </rule>
</rules>

Переработка карт

Карта перезаписи — это произвольный набор пар "имя-значение", которые можно использовать в правилах перезаписи для создания URL-адреса подстановки во время перезаписи. Перезапись карт особенно полезна, если у вас есть большой набор правил перезаписи, и все эти правила используют статические строки (то есть при отсутствии сопоставления шаблонов). В этих случаях вместо определения большого набора простых правил перезаписи можно поместить все сопоставления в карту перезаписи в виде ключей и значений между входным URL-адресом и URL-адресом подстановки. Для определения URL-адреса замены на основе исходного URL-адреса у вас будет одно правило переписывания, ссылающееся на карту переписывания.

Карта перезаписи определяет именованную коллекцию строк пар "имя-значение", как показано в следующем примере:

<rewriteMap name="MyRewriteMap" defaultValue="">
  <add key="a.html" value="b.html" />
  <add key="c.aspx" value="d.aspx" />
  <add key="e.php" value="f.php" />
</rewriteMap>

Карта перезаписи однозначно определяется его именем и может содержать ноль или больше записей key-value. Кроме того, карта перезаписи может указать значение по умолчанию, используемое, если ключ не найден. Это управляется с помощью атрибута defaultValue . По умолчанию пустая строка используется в качестве значения по умолчанию.

На любом уровне конфигурации может быть любое количество карт перезаписи, кроме уровня файла. Карты перезаписи размещены в элементе коллекции <rewriteMaps>.

Карты перезаписи используются в правилах перезаписи с помощью следующего синтаксиса:

{RewriteMapName:Key}

Где параметр Key может быть любой произвольной строкой и может включать обратные ссылки на правила или шаблоны условий. Например, ниже приведены допустимые варианты использования карты перезаписи:

{MyRewriteMap:contoso/{R:1}/test/{C:1}}
{MyRewriteMap:a.html}
{MyRewriteMap:{R:1}?{C:1}&contoso=test}

Ссылка на карту перезаписи заменяется значением, которое было найдено по ключу, переданному в качестве параметра в ссылке на карту перезаписи. Если ключ не найден, используется значение по умолчанию для этой карты перезаписи.

На карту перезаписи можно ссылаться в следующих расположениях в правилах перезаписи:

  • В строке условия ввода

  • В строках подстановки правил, в частности:

    • Атрибут URL-адреса действий перезаписи и перенаправления
    • statusLine и responseLine действий CustomResponse

Пример 1. С помощью карты перезаписи, определенной следующим образом:

<rewrite>
 <rewriteMaps>
  <rewriteMap name="StaticRewrites" defaultValue="">
    <add key="/diagnostics" value="/default.aspx?tabid=2&amp;subtabid=29" />
    <add key="/webcasts" value="/default.aspx?tabid=2&amp;subtabid=24" />
    <add key="/php" value="/default.aspx?tabid=7116" />
  </rewriteMap>
 </rewriteMaps>
</rewrite>

И правило перезаписи, определенное следующим образом:

<rewrite>
 <rule name="Rewrite Rule">
  <match url=".*" />
  <conditions>
   <add input="{StaticRewrites:{REQUEST_URI}}" pattern="(.+)" />
  </conditions>
  <action type="Rewrite" url="{C:1}"/>
 </rule>
</rewrite>

Запрошенный URL-адрес /diagnostic будет перезаписан как /default.aspx?tabid=2&subtabid=29.
Запрошенный URL-адрес /webcasts будет перезаписан в /default.aspx?tabid=2&subtabid=24.
Запрошенный URL-адрес /php будет перезаписан в /default.aspx?tabid=7116.
Запрошенный URL-адрес /default.aspx не будет перезаписан, так как карта перезаписи не содержит элемент с ключом="/default.aspx"; Поэтому карта перезаписи возвращает пустую строку, которая не будет соответствовать шаблону условия, поэтому действие правила не будет выполнено.

Пример 2: С картой перезаписи, определенной следующим образом:

<rewrite>
 <rewriteMaps>
  <rewriteMap name="StaticRedirects" defaultValue="">
    <add key="/default.aspx?tabid=2&amp;subtabid=29" value="/diagnostics" />
    <add key="/default.aspx?tabid=2&amp;subtabid=24" value="/webcasts" />
    <add key="/default.aspx?tabid=7116" value="/php" />
  </rewriteMap>
 </rewriteMaps>
</rewrite>

И правило перезаписи, определенное следующим образом:

<rewrite>
 <rule name="Redirect rule">
  <match url=".*" />
  <conditions>
   <add input="{StaticRedirects:{REQUEST_URI}}" pattern="(.+)" />
  </conditions>
  <action type="Redirect" url="http://www.contoso.com{C:1}" redirectType="Found" />
 </rule>
</rewrite>

Запрошенный URL-адрес /default.aspx?tabid=2&subtabid=29 будет перенаправлен в http://www.contoso.com/diagnostics.
Запрошенный URL-адрес /default.aspx?tabid=2&subtabid=24 будет перенаправлен в http://www.contoso.com/webcasts.
Запрошенный URL-адрес /default.aspx?tabid=7116 будет перенаправлен в http://www.contoso.com/php.
Запрошенный URL-адрес /default.aspx не будет перенаправлен, так как карта перезаписи не содержит элемент с ключом="/default.aspx"; Поэтому карта перезаписи возвращает пустую строку, которая не будет соответствовать шаблону условия, поэтому действие правила не будет выполнено.