Values - коллекция уровня страницы. Время жизни - текущий запрос. Подробнее о механизме Values.
public void AddValue(string key, object value)
Метод добавляет пару ключ/значение в коллекцию Values. Получить значение по ключу можно затем c помощью методов DirtyValue, Value, StrValue, NumValue.
AddValue("Age", 35);
string Value(string key)
Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). С целью предотвращения атаки типа SQL-инъекции из результата удаляются апострофы. Используйте метод DirtyValue, чтобы прочитать неизмененное значение.
public string DirtyValue(string key)
Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). В отличие от других методов не изменяет возвращаемый результат.
public long NumValue(string key)
Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). Результат преобразуется в число. Если преобразование неуспешно, то возвращается 0. Таким образом метод гарантированно возвращает число, что делает его безопасным с точки зрения атаки типа SQL-иньекции. Поэтому он рекомендуется для передачи числовых параметров в объект типа Publishing Container. Для безопасной передачи строковых параметров используйте метод StrValue.
"[content_item_id] = " + NumValue("id")
public string StrValue(string key)
Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). Все апострофы в результирующей строке удваиваются, что предотвращает атаку типа SQL-инъекции с использованием данного параметра. Рекомендуется использовать данный метод при передаче строковых параметров в объект типа Publishing Container. Для передачи числовых параметров используйте метод NumValue.
"[text] = '" + StrValue("text") + "'"
Discussion