User Tools

Site Tools


api:qpage:values

Методы для работы с коллекцией Values

Values - коллекция уровня страницы. Время жизни - текущий запрос. Подробнее о механизме Values.

AddValue

 public void AddValue(string key, object value)

Метод добавляет пару ключ/значение в коллекцию Values. Получить значение по ключу можно затем c помощью методов DirtyValue, Value, StrValue, NumValue.

Пример

AddValue("Age", 35);

Value

string Value(string key)

Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). С целью предотвращения атаки типа SQL-инъекции из результата удаляются апострофы. Используйте метод DirtyValue, чтобы прочитать неизмененное значение.

DirtyValue

public string DirtyValue(string key)

Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). В отличие от других методов не изменяет возвращаемый результат.

NumValue

public long NumValue(string key)

Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). Результат преобразуется в число. Если преобразование неуспешно, то возвращается 0. Таким образом метод гарантированно возвращает число, что делает его безопасным с точки зрения атаки типа SQL-иньекции. Поэтому он рекомендуется для передачи числовых параметров в объект типа Publishing Container. Для безопасной передачи строковых параметров используйте метод StrValue.

Пример

"[content_item_id] = " + NumValue("id")

StrValue

public string StrValue(string key)

Возвращает значение из коллекции Values по заданному ключу (ключ не зависит от регистра). Все апострофы в результирующей строке удваиваются, что предотвращает атаку типа SQL-инъекции с использованием данного параметра. Рекомендуется использовать данный метод при передаче строковых параметров в объект типа Publishing Container. Для передачи числовых параметров используйте метод NumValue.

Пример

"[text] = '" + StrValue("text") + "'"

Discussion

Enter your comment
 
api/qpage/values.txt · Last modified: 2012/06/19 14:06 by celutp