Что делает Microsoft.Security.Application.Encoder.UrlPathEncode?

c# html-agility-pack

Вопрос

Я нашел блестящий пример дезинфицирующего средства для HTML, использующего HTMLAgilityPack. В коде используется класс Microsoft.Security.Application.Encoder :

// AntiXss
a.Value = Microsoft.Security.Application.Encoder.UrlPathEncode(a.Value);

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

Чтобы решить, для или против использования этой сборки, я хотел бы знать: что делает этот метод на самом деле?

Принятый ответ

Вы можете посмотреть исходный код

Из исходного кода метода

/// <summary>
/// URL-encodes the path section of a URL string and returns the encoded string.
/// </summary>
/// <param name="input">The text to URL path encode</param>
/// <returns>The URL path encoded text.</returns>
[System.Diagnostics.CodeAnalysis.SuppressMessage(
    "Microsoft.Design",
    "CA1055:UriReturnValuesShouldNotBeStrings",
    Justification = "This does not return a full URL so the return type can be a string.")]
public static string UrlPathEncode(string input)
{
    if (string.IsNullOrEmpty(input)) 
    { 
        return input; 
    } 

    // DevDiv #211105: We should make the UrlPathEncode method encode only the path portion of URLs. 
    string schemeAndAuthority; 
    string path; 
    string queryAndFragment; 
    bool validUrl = UriUtil.TrySplitUriForPathEncode(input, out schemeAndAuthority, out path, out queryAndFragment);

    if (!validUrl) 
    { 
        // treat as a relative URL, so we might still need to chop off the query / fragment components 
        schemeAndAuthority = null; 
        UriUtil.ExtractQueryAndFragment(input, out path, out queryAndFragment); 
    } 

    return schemeAndAuthority + HtmlParameterEncoder.UrlPathEncode(path, Encoding.UTF8) + queryAndFragment; 
}

Вам придется копать глубже, чтобы добраться до всех движущихся частей при кодировании uri. Обычно я бы рекомендовал изучить модульные тесты, чтобы увидеть, что ожидается от компонента, но на первый взгляд нет тестов на классе Encoder :(



Лицензировано согласно: CC-BY-SA with attribution
Не связан с Stack Overflow
Является ли этот КБ законным? Да, узнайте, почему
Лицензировано согласно: CC-BY-SA with attribution
Не связан с Stack Overflow
Является ли этот КБ законным? Да, узнайте, почему