User Tools

Site Tools


api:field

This is an old revision of the document!


Работа с полями

Field

string Field(DataRowView pDataItem, string key)
string Field(DataRowView pDataItem, string key, string defaultvalue) 
string Field(DataRow pDataItem, string key)
string Field(DataRow pDataItem, string key, string defaultvalue)

Возвращает значение поля key для данного DataRowView. Для возвращаемого значения выполняется замена плейсхолдеров. Если нужно выполнить только замену без чтения данных, нужно воспользоваться функцией FormatField. В режиме OnScreen функция Field генерирует редактируемую обертку (тег div с тулбаром). Если данное поведение нежелательно, то нужно использовать функцию FieldNS. Второй вариант метода позволяет задать значение по умолчанию, которое будет применено, если значение, полученное из таблицы - NULL или пустая строка. 3-й и 4-й варианты аналогичны первым двум, но вместо DataRowView используется DataRow. Обычно первые два варианта применяются в Presentation, а вторые два - в Code Behind.

Пример использования в Presentation объекта типа Publishing Container с кодом по умолчанию:

<ItemTemplate>
...
<%# Field(((DataRowView)(Container.DataItem)), "Title")%>
...
</ItemTemplate>

Пример для Code Behind объекта типа Publishing Container:

protected void OnItemCreated(Object sender, RepeaterItemEventArgs e) {
  if ((e.Item.ItemType == ListItemType.Item) | (e.Item.ItemType == ListItemType.AlternatingItem)) { 
...
string title = Field(Data.Rows[e.Item.ItemIndex], "Title");
...
  }
}

Метод Field можно применять не только в объектах типа Publishing Container, но и в других типах объектов.

FieldNS

string FieldNS(DataRowView pDataItem, string key)
string FieldNS(DataRowView pDataItem, string key, string defaultvalue)
string FieldNS(DataRow pDataItem, string key)
string FieldNS(DataRow pDataItem, string key, string defaultvalue)

Аналогично методу Field, но в режиме OnScreen не генерируется код для редактирования данного поля. Рекомендуется применять в случаях, когда вставка дополнительного кода может поломать верстку.

FormatField

string FormatField(string key)

Данный метод выполняет замену плейсхолдеров на URL.

Нужно применять данный метод при чтении из базы данных полей способом, отличным от двух перечисленных ниже:

  • Функция Field
  • Классы LINQ-To-SQL

OnScreenFlyEdit

string OnScreenFlyEdit(string Value, int ItemID, string FieldName)

Данный метод используется для того, чтобы получить функциональность режима OnScreen вне Publishing-контейнеров. Параметры метода включают в себя:

  • текст, который должен быть отредактирован
  • ID статьи
  • имя поля

OnScreen

string OnScreen(string Value, int ItemID)

Упрощенная версия метода OnScreenFlyEdit method. C его помощью пользователь может отредактировать статью только в Form View, но не в режиме OnFly.

Discussion

Enter your comment
 
api/field.1258803654.txt.gz · Last modified: 2009/11/21 14:40 by celutp