Spec-Zone.ru › ColdFusion

queryNew

Создает новый объект запроса. Запрос можно заполнить данными с помощью функций queryAddRow, querySetCell или передав данные в аргумент rowData.

queryNew(columnList [, columnTypeList [, rowData]]) → returns query

  • CF3+
  • Lucee
  • BL 1.0.0+
  • См. также: queryaddrow querysetcell queryaddcolumn

    Справочник аргументов

    columnList string
    Обязательный

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

    columnTypeList string

    CF 7+ Список типов данных столбцов, разделенных запятыми.
    Значения:
    • Integer
    • BigInt
    • Double
    • Decimal
    • VarChar
    • Binary
    • Bit
    • Time
    • Date
    • Timestamp

    rowData any

    CF 10+ Данные для заполнения запроса. Это может быть структура (с ключами, соответствующими именам столбцов), массив структур или массив массивов (в том же порядке, что и в columnList).

    Примеры
    Пример кода с вызовом функции queryNew

    Создание простого запроса с помощью queryNew

    Использование скрипта с функциями queryAddRow и querySetCell для заполнения запроса.

    news = queryNew("id,title", "integer,varchar");
    queryAddRow(news);
    querySetCell(news, "id", "1");
    querySetCell(news, "title", "Dewey defeats Truman");
    queryAddRow(news);
    querySetCell(news, "id", "2");
    querySetCell(news, "title", "Men walk on Moon");
    writeDump(news);

    Создание простого запроса с помощью queryNew

    Использование тегов CFML с функциями queryAddRow и querySetCell для заполнения запроса.

    <cfset news = queryNew("id,title", "integer,varchar")>
    <cfset queryAddRow(news)>
    <cfset querySetCell(news, "id", "1")>
    <cfset querySetCell(news, "title", "Dewey defeats Truman")>
    <cfset queryAddRow(news)>
    <cfset querySetCell(news, "id", "2")>
    <cfset querySetCell(news, "title", "Men walk on Moon")>
    <cfset writeDump(news)>

    Создание и заполнение запроса с помощью массива в rowData функции queryNew

    CF 10+ Передача массива структур для создания нового запроса.

    news = queryNew("id,title",
        "integer,varchar",
        [ {"id":1,"title":"Dewey defeats Truman"}, {"id":2,"title":"Man walks on Moon"} ]);
    writeDump(news);

    Создание и заполнение запроса с одной строкой с помощью rowData функции queryNew

    CF 10+ Если нужна только одна строка, вместо массива можно передать одну структуру в аргумент rowData.

    news = queryNew("id,title",
        "integer,varchar",
        {"id":1,"title":"Dewey defeats Truman"});
    writeDump(news);

    Создание и заполнение запроса массивом структур

    CF2018u5+ Столбцы и значения назначаются напрямую с помощью массива структур.

    news = queryNew([
        {"id":1,"title":"Dewey defeats Truman"},
        {"id":2,"title":"Man walks on Moon"}
    ]);
    writeDump(news);

    © 2012–present Foundeo, Inc. and the CFDocs contributors.
    Licensed under the MIT License.
    ColdFusion is a trademark of Adobe Systems Incorporated.
    https://cfdocs.org/querynew

    Spec-Zone.ru

    Настройки Оффлайн Что нового Помощь О нас
    Spec-Zone .ru
    спецификации, руководства, описания, API