ТаблицаДанных.Выбрать (DataTable.Select) Метод

Синтаксис

Выбрать(<Фильтр>)

Параметры

Фильтр (обязательный)
Тип: Строка.

Возвращаемое значение

Тип: МассивСписок (ArrayList).

Описание

Возвращает коллекцию всех объектов СтрокаДанных (DataRow), отвечающих условиям фильтра.

Примечание

Дополнительные сведения по синтаксису параметра Фильтр:

DataView RowFilter Syntax [C#]

This example describes syntax of DataView.RowFil­ter expression. It shows how to correctly build expression string (without „SQL injection“) 
using methods to escape values.
Column names

If a column name contains any of these special characters ~ ( ) # \ / = > < + - * % & | ^ ' " [ ], you must enclose the column name within 
square brackets [ ]. If a column name contains right bracket ] or backslash \, escape it with backslash (\] or \\).
[C#]

dataView.RowFilter = "id = 10";      // no special character in column name "id"
dataView.RowFilter = "$id = 10";     // no special character in column name "$id"
dataView.RowFilter = "[#id] = 10";   // special character "#" in column name "#id"
dataView.RowFilter = "[[id\]] = 10"; // special characters in column name "[id]"

Literals

String values are enclosed within single quotes ' '. If the string contains single quote ', the quote must be doubled.
[C#]

dataView.RowFilter = "Name = 'John'"        // string value
dataView.RowFilter = "Name = 'John ''A'''"  // string with single quotes "John 'A'"

dataView.RowFilter = String.Format("Name = '{0}'", "John 'A'".Replace("'", "''"));

Number values are not enclosed within any characters. The values should be the same as is the result of int.ToString() or float.ToString() method 
for invariant or English culture.
[C#]

dataView.RowFilter = "Year = 2008"          // integer value
dataView.RowFilter = "Price = 1199.9"       // float value

dataView.RowFilter = String.Format(CultureInfo.InvariantCulture.NumberFormat,
                     "Price = {0}", 1199.9f);

Date values are enclosed within sharp characters # #. The date format is the same as is the result of DateTime.ToString() method for invariant 
or English culture.
[C#]

dataView.RowFilter = "Date = #12/31/2008#"          // date value (time is 00:00:00)
dataView.RowFilter = "Date = #2008-12-31#"          // also this format is supported
dataView.RowFilter = "Date = #12/31/2008 16:44:58#" // date and time value

dataView.RowFilter = String.Format(CultureInfo.InvariantCulture.DateTimeFormat,
                     "Date = #{0}#", new DateTime(2008, 12, 31, 16, 44, 58));

Alternatively you can enclose all values within single quotes ' '. It means you can use string values for numbers or date time values. In this 
case the current culture is used to convert the string to the specific value.
[C#]

dataView.RowFilter = "Date = '12/31/2008 16:44:58'" // if current culture is English
dataView.RowFilter = "Date = '31.12.2008 16:44:58'" // if current culture is German

dataView.RowFilter = "Price = '1199.90'"            // if current culture is English
dataView.RowFilter = "Price = '1199,90'"            // if current culture is German

Comparison operators

Equal, not equal, less, greater operators are used to include only values that suit to a comparison expression. You can use these operators = <> < <= > >=.

Note: String comparison is culture-sensitive, it uses CultureInfo from DataTable.Locale property of related table (dataView.Table.Locale). If 
the property is not explicitly set, its default value is DataSet.Locale (and its default value is current system culture Thread.Curren­tThread.Curren­tCulture).
[C#]

dataView.RowFilter = "Num = 10"             // number is equal to 10
dataView.RowFilter = "Date < #1/1/2008#"    // date is less than 1/1/2008
dataView.RowFilter = "Name <> 'John'"       // string is not equal to 'John'
dataView.RowFilter = "Name >= 'Jo'"         // string comparison

Operator IN is used to include only values from the list. You can use the operator for all data types, such as numbers or strings.
[C#]

dataView.RowFilter = "Id IN (1, 2, 3)"                    // integer values
dataView.RowFilter = "Price IN (1.0, 9.9, 11.5)"          // float values
dataView.RowFilter = "Name IN ('John', 'Jim', 'Tom')"     // string values
dataView.RowFilter = "Date IN (#12/31/2008#, #1/1/2009#)" // date time values

dataView.RowFilter = "Id NOT IN (1, 2, 3)"  // values not from the list

Operator LIKE is used to include only values that match a pattern with wildcards. Wildcard character is * or %, it can be at the beginning 
of a pattern '*value', at the end 'value*', or at both '*value*'. Wildcard in the middle of a patern 'va*lue' is not allowed.
[C#]

dataView.RowFilter = "Name LIKE 'j*'"       // values that start with 'j'
dataView.RowFilter = "Name LIKE '%jo%'"     // values that contain 'jo'

dataView.RowFilter = "Name NOT LIKE 'j*'"   // values that don't start with 'j'

If a pattern in a LIKE clause contains any of these special characters * % [ ], those characters must be escaped in brackets [ ] like this [*], [%], [[] or []].
[C#]

dataView.RowFilter = "Name LIKE '[*]*'"     // values that starts with '*'
dataView.RowFilter = "Name LIKE '[[]*'"     // values that starts with '['

The following method escapes a text value for usage in a LIKE clause.
[C#]

public static string EscapeLikeValue(string valueWithoutWildcards)
{
  StringBuilder sb = new StringBuilder();
  for (int i = 0; i < valueWithoutWildcards.Length; i++)
  {
    char c = valueWithoutWildcards[i];
    if (c == '*' || c == '%' || c == '[' || c == ']')
      sb.Append("[").Append(c).Append("]");
    else if (c == '\'')
      sb.Append("''");
    else
      sb.Append(c);
  }
  return sb.ToString();
}

[C#]

// select all that starts with the value string (in this case with "*")
string value = "*";
// the dataView.RowFilter will be: "Name LIKE '[*]*'"
dataView.RowFilter = String.Format("Name LIKE '{0}*'", EscapeLikeValue(value));

Boolean operators

Boolean operators AND, OR and NOT are used to concatenate expressions. Operator NOT has precedence over AND operator and it has precedence over OR operator.
[C#]

// operator AND has precedence over OR operator, parenthesis are needed
dataView.RowFilter = "City = 'Tokyo' AND (Age < 20 OR Age > 60)";

// following examples do the same
dataView.RowFilter = "City <> 'Tokyo' AND City <> 'Paris'";
dataView.RowFilter = "NOT City = 'Tokyo' AND NOT City = 'Paris'";
dataView.RowFilter = "NOT (City = 'Tokyo' OR City = 'Paris')";
dataView.RowFilter = "City NOT IN ('Tokyo', 'Paris')";

Arithmetic and string operators

Arithmetic operators are addition +, subtraction -, multiplication *, division / and modulus %.
[C#]

dataView.RowFilter = "MotherAge - Age < 20";   // people with young mother
dataView.RowFilter = "Age % 10 = 0";           // people with decennial birthday

There is also one string operator concatenation +.
Parent-Child Relation Referencing

A parent table can be referenced in an expression using parent column name with Parent. prefix. A column in a child table can be referenced 
using child column name with Child. prefix.

The reference to the child column must be in an aggregate function because child relationships may return multiple rows. For example expression 
SUM(Child.Price) returns sum of all prices in child table related to the row in parent table.

If a table has more than one child relation, the prefix must contain relation name. For example expression Child(OrdersToItemsRelation).Price 
references to column Price in child table using relation named OrdersToItemsRe­lation.
Aggregate Functions

There are supported following aggregate functions SUM, COUNT, MIN, MAX, AVG (average), STDEV (statistical standard deviation) and VAR (statistical variance).

This example shows aggregate function performed on a single table.
[C#]

// select people with above-average salary
dataView.RowFilter = "Salary > AVG(Salary)";

Following example shows aggregate functions performed on two tables which have parent-child relation. Suppose there are tables Orders and Items 
with the parent-child relation.
[C#]

// select orders which have more than 5 items
dataView.RowFilter = "COUNT(Child.IdOrder) > 5";

// select orders which total price (sum of items prices) is greater or equal $500
dataView.RowFilter = "SUM(Child.Price) >= 500";

Functions

There are also supported following functions. Detailed description can be found here DataColumn.Ex­pression.

    CONVERT – converts particular expression to a specified .NET Framework type
    LEN – gets the length of a string
    ISNULL – checks an expression and either returns the checked expression or a replacement value
    IIF – gets one of two values depending on the result of a logical expression
    TRIM – removes all leading and trailing blank characters like \r, \n, \t, ‚ ‘
    SUBSTRING – gets a sub-string of a specified length, starting at a specified point in the string


See also

    http://msdn2.microsoft.com/en-us/library/system.data.dataview.rowfilter.aspx – MSDN – expression used to filter rows
    http://msdn2.microsoft.com/en-us/library/system.data.datacolumn.expression.aspx – MSDN – syntax description

Пример

М1 = ТаблицаДанных1.Выбрать(Фильтр1);
Полный пример кода 

Копировать     Выделить всё


ПодключитьВнешнююКомпоненту("C:\444\111\OneScriptForms\OneScriptForms\bin\Debug\OneScriptForms.dll");
Ф = Новый ФормыДляОдноСкрипта();
Форма1 = Ф.Форма();
Форма1.Ширина = 400;
Форма1.Отображать = Истина;
Форма1.Показать();
Форма1.Активизировать();

СеткаДанных1 = Форма1.ЭлементыУправления.Добавить(Ф.СеткаДанных());
СеткаДанных1.Стыковка = Ф.СтильСтыковки.Заполнение;

ТаблицаДанных1 = Ф.ТаблицаДанных("ТД1");
Колонки1 = ТаблицаДанных1.Колонки;
Колонка1 = Колонки1.Добавить(Ф.КолонкаДанных("№ н/п", Ф.ТипДанных.Число));
Колонка2 = Колонки1.Добавить(Ф.КолонкаДанных("ФИО", Ф.ТипДанных.Строка));

Строки1 = ТаблицаДанных1.Строки;
ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 1);
ТекСтрока.УстановитьЭлемент("ФИО", "Иванов Иван Иванович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 2);
ТекСтрока.УстановитьЭлемент("ФИО", "Семенов Семен Семенович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 3);
ТекСтрока.УстановитьЭлемент("ФИО", "Шикалов Игнатий Маркович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 4);
ТекСтрока.УстановитьЭлемент("ФИО", "Петров Петр Петрович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 5);
ТекСтрока.УстановитьЭлемент("ФИО", "Сергеевич Аристарх Изяславович");

СтильТаблицыСеткиДанных1 = Ф.СтильТаблицыСеткиДанных();
СтильТаблицыСеткиДанных1.ИмяОтображаемого = "ТД1";

СтильКолонкиПолеВвода1 = Ф.СтильКолонкиПолеВвода();
СтильКолонкиПолеВвода1.ИмяОтображаемого = "№ н/п";
СтильКолонкиПолеВвода1.Ширина = 50;
СтильКолонкиПолеВвода1.ТекстЗаголовка = "№ н/п";
СтильКолонкиПолеВвода1.Выравнивание = Ф.ГоризонтальноеВыравнивание.Право;

СтильКолонкиПолеВвода2 = Ф.СтильКолонкиПолеВвода();
СтильКолонкиПолеВвода2.ИмяОтображаемого = "ФИО";
СтильКолонкиПолеВвода2.Ширина = 200;
СтильКолонкиПолеВвода2.ТекстЗаголовка = "ФИО";

СтилиКолонкиСеткиДанных1 = СтильТаблицыСеткиДанных1.СтилиКолонкиСеткиДанных;
СтилиКолонкиСеткиДанных1.Добавить(СтильКолонкиПолеВвода1);
СтилиКолонкиСеткиДанных1.Добавить(СтильКолонкиПолеВвода2);

СеткаДанных1.СтилиТаблицы.Добавить(СтильТаблицыСеткиДанных1);

ПредставлениеДанных1 = ТаблицаДанных1.ПредставлениеПоУмолчанию;
СеткаДанных1.ИсточникДанных = ПредставлениеДанных1;

Фильтр1 = "[ФИО] = 'Шикалов Игнатий Маркович'";//верно
Фильтр1 = "ФИО LIKE 'Шикалов Игнатий Маркович'";//верно
Фильтр1 = "[№ н/п] = 5 AND ФИО = 'Шикалов Игнатий Маркович'";//верно
Фильтр1 = "[ДатаРождения] > #11/29/1995#";//верно "[ДатаРождения] > #месяц/день/год#"
Фильтр1 = "[ФИО] >= 'Шикалов'";//верно по фрагменту
Фильтр1 = "[ФИО] IN ('Шикалов Игнатий Маркович', 'Сергеевич Аристарх Изяславович', 'Иванов Иван Иванович')";//верно

М1 = ТаблицаДанных1.Выбрать(Фильтр1);
Для А = 0 По М1.Количество - 1 Цикл
	ЭлементДанных1 = М1.Элемент(А).Элемент("ФИО");
	Сообщить("Ячейка0 = " + М1.Элемент(А).Элемент(0).Значение);
	Сообщить("Ячейка1 = " + ЭлементДанных1.Значение);
КонецЦикла;

Ф.ЗапуститьОбработкуСобытий();

Тестовый код 

Копировать     Выделить всё


ПодключитьВнешнююКомпоненту("C:\444\111\OneScriptForms\OneScriptForms\bin\Debug\OneScriptForms.dll");
Ф = Новый ФормыДляОдноСкрипта();
Форма1 = Ф.Форма();
Форма1.Ширина = 400;
Форма1.Отображать = Истина;
Форма1.Показать();
Форма1.Активизировать();

СеткаДанных1 = Форма1.ЭлементыУправления.Добавить(Ф.СеткаДанных());
СеткаДанных1.Стыковка = Ф.СтильСтыковки.Заполнение;

ТаблицаДанных1 = Ф.ТаблицаДанных("ТД1");
Колонки1 = ТаблицаДанных1.Колонки;
Колонка1 = Колонки1.Добавить(Ф.КолонкаДанных("№ н/п", Ф.ТипДанных.Число));
Колонка2 = Колонки1.Добавить(Ф.КолонкаДанных("ФИО", Ф.ТипДанных.Строка));

Строки1 = ТаблицаДанных1.Строки;
ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 1);
ТекСтрока.УстановитьЭлемент("ФИО", "Иванов Иван Иванович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 2);
ТекСтрока.УстановитьЭлемент("ФИО", "Семенов Семен Семенович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 3);
ТекСтрока.УстановитьЭлемент("ФИО", "Шикалов Игнатий Маркович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 4);
ТекСтрока.УстановитьЭлемент("ФИО", "Петров Петр Петрович");

ТекСтрока = Строки1.Добавить(ТаблицаДанных1.НоваяСтрока());
ТекСтрока.УстановитьЭлемент("№ н/п", 5);
ТекСтрока.УстановитьЭлемент("ФИО", "Сергеевич Аристарх Изяславович");

СтильТаблицыСеткиДанных1 = Ф.СтильТаблицыСеткиДанных();
СтильТаблицыСеткиДанных1.ИмяОтображаемого = "ТД1";

СтильКолонкиПолеВвода1 = Ф.СтильКолонкиПолеВвода();
СтильКолонкиПолеВвода1.ИмяОтображаемого = "№ н/п";
СтильКолонкиПолеВвода1.Ширина = 50;
СтильКолонкиПолеВвода1.ТекстЗаголовка = "№ н/п";
СтильКолонкиПолеВвода1.Выравнивание = Ф.ГоризонтальноеВыравнивание.Право;

СтильКолонкиПолеВвода2 = Ф.СтильКолонкиПолеВвода();
СтильКолонкиПолеВвода2.ИмяОтображаемого = "ФИО";
СтильКолонкиПолеВвода2.Ширина = 200;
СтильКолонкиПолеВвода2.ТекстЗаголовка = "ФИО";

СтилиКолонкиСеткиДанных1 = СтильТаблицыСеткиДанных1.СтилиКолонкиСеткиДанных;
СтилиКолонкиСеткиДанных1.Добавить(СтильКолонкиПолеВвода1);
СтилиКолонкиСеткиДанных1.Добавить(СтильКолонкиПолеВвода2);

СеткаДанных1.СтилиТаблицы.Добавить(СтильТаблицыСеткиДанных1);

ПредставлениеДанных1 = ТаблицаДанных1.ПредставлениеПоУмолчанию;
СеткаДанных1.ИсточникДанных = ПредставлениеДанных1;

Фильтр1 = "[ФИО] = 'Шикалов Игнатий Маркович'";//верно
Фильтр1 = "ФИО LIKE 'Шикалов Игнатий Маркович'";//верно
Фильтр1 = "[№ н/п] = 5 AND ФИО = 'Шикалов Игнатий Маркович'";//верно
Фильтр1 = "[ДатаРождения] > #11/29/1995#";//верно "[ДатаРождения] > #месяц/день/год#"
Фильтр1 = "[ФИО] >= 'Шикалов'";//верно по фрагменту
Фильтр1 = "[ФИО] IN ('Шикалов Игнатий Маркович', 'Сергеевич Аристарх Изяславович', 'Иванов Иван Иванович')";//верно

М1 = ТаблицаДанных1.Выбрать(Фильтр1);

Сообщить(?(
М1.Количество = 3
, "", "!!! ") + "ТаблицаДанных.Выбрать (DataTable.Select) Метод" + " " + ТекущаяДата());

Смотрите также

ТаблицаДанных (DataTable) Класс | Библиотека OneScriptForms