SecondaryGetDataConnection

Вторично загружающее соединение с данными; получает данные из другого загружающего соединения с данными и фильтрует их.

Шаблон SecondaryGetDataConnection

<DataConnection Name="" Type="SecondaryGetDataConnection" Assembly="DataConnections">
  <SourceDataConnection Name="" SqlQuery="" />
  <ManualRefresh></ManualRefresh> 
  <Filter>
    <And RefreshFilter="">
      <Or RefreshFilter="">
        <Filter Type="" FilterByNullValue="" RefreshFilter="" Reverse="">
          <Field NativeName="" />
          <Value></Value>
          <DataType Type="" />
          <Enabled>True</Enabled>
        </Filter>
        <Filter Type="" FilterByNullValue="" RefreshFilter="" Reverse="">
          <Field NativeName="" />
          <Value></Value>
          <DataType Type="" />
          <Enabled>True</Enabled>
        </Filter>
      </Or>
      <Not RefreshFilter="">
        <Filter Type="" FilterByNullValue="" RefreshFilter="" Reverse="">
          <Field NativeName="" />
          <Value></Value>
          <DataType Type="" />
          <Enabled>True</Enabled>
        </Filter>
      </Not>
    </And>
  </Filter>
  <StartPosition></StartPosition>
  <MaxCount></MaxCount>
</DataConnection>

Описание SecondaryGetDataConnection

<DataConnection Name="SecondaryGetDataConnectionName" Type="SecondaryGetDataConnection" Assembly="DataConnections">
  <!--Тэги, специфичные для SecondaryGetDataConnection-->
</DataConnection>

Тэги, специфичные для SecondaryGetDataConnection

SourceDataConnection

Первично загружающее соединение с данными, данные которого будут фильтроваться.

Обязательный тэг. Значение тэга <SourceDataConnection>: не ожидается.

<SourceDataConnection Name="SourceDataConnectionName" SqlQuery="SqlQueryName" />

Атрибуты тэга <SourceDataConnection>

Name	Имя первично загружающего соединения с данными. Обязательный атрибут. Ожидается имя одного из первично загружающих соединений с данными, описанных в форме.
SqlQuery	Имя запроса из загружающего соединения. Необязательный атрибут. Ожидается имя одного из запросов из загружающего соединения с данными.

ManualRefresh

Признак, определяющий, будет ли загрузка данных автоматически производиться при изменении первичного загружающего соединения-источника.

Необязательный тэг. Ожидается логическое значение.

Если тэг <ManualRefresh> отсутствует, то используется значение True.

<ManualRefresh>True</ManualRefresh>

Filter

Фильтр полученных данных.

Фильтрация происходит без повторных запросов в базу данных.

Необязательный тэг. Значение тэга <Filter>: список тэгов <And>, <Or> и <Not> или тэги <Field>, <Value> и <DataType>.

<Filter>
  <And RefreshFilter="True">
    <Or RefreshFilter="True">
      <Filter Type="Equal" FilterByNullValue="True" RefreshFilter="True" Reverse="True">
        <Field NativeName="FieldName1" />
        <Value>Value</Value>
        <DataType Type="DataTypeName" />
        <Enabled>True</Enabled>
      </Filter>
      <Filter Type="Equal" FilterByNullValue="True" RefreshFilter="True" Reverse="True">
        <Field NativeName="FieldName2" />
        <Value>Value</Value>
        <Enabled>True</Enabled>
      </Filter>
    </Or>
    <Not RefreshFilter="True">
      <Filter Type="Equal" FilterByNullValue="True" RefreshFilter="True" Reverse="True">
        <Field NativeName="FieldName3" />
        <Value>Value</Value>
        <DataType Type="DataTypeName" />
        <Enabled>True</Enabled>
      </Filter>
    </Not>
  </And>
</Filter>

Атрибуты тэга <Filter>

Type	Тип сравнения значений. Необязательный атрибут. Ожидается название одного из типов сравнения значений. Если атрибут Type отсутствует, то используется значение Equal.
FilterByNullValue	Признак, определяющий, будет ли осуществляться фильтрация для очередной строки соединения с данными, если значение фильтра будет равно NULL. Необязательный атрибут. Ожидается логическое значение. Если атрибут FilterByNullValue отсутствует, то используется значение True.
RefreshFilter	Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении параметра фильтра. Признак не работает для фильтров, содержащих внутри себя тэги <And>, <Or> или <Not>, для таких фильтров данные обновляются всегда. Необязательный атрибут. Ожидается логическое значение. Если атрибут RefreshFilter отсутствует, то используется значение True.
Reverse	Признак, определяющий, будет ли изменён порядок аргументов фильтра на обратный. Необязательный атрибут. Ожидается логическое значение. Если атрибут Reverse отсутствует, то используется значение False.

Типы сравнения значений

Equal	Сравнение значений на равенство
NotEqual	Сравнение значений на неравенство
Greater	Сравнение значений на "больше": значение из соединения с данными больше указанного значения
NotGreater	Сравнение значений на "не больше": значение из соединения с данными не больше указанного значения
Less	Сравнение значений на "меньше": значение из соединения с данными меньше указанного значения
NotLess	Сравнение значений на "не меньше": значение из соединения с данными не меньше указанного значения
Contains	Сравнение значений на "содержит": значение из соединения с данными содержит указанное значение (значения любых типов данных преобразуются к строковому типу)
NotContains	Сравнение значений на "не содержит": значение из соединения с данными не содержит указанное значение (значения любых типов данных преобразуются к строковому типу)
In	Сравнение значений на "входит": значение из соединения с данными входит в указанный массив
NotIn	Сравнение значений на "не входит": значение из соединения с данными не входит в указанный массив
Overlap	Сравнение значений на "пересекается": массив из соединения с данными имеет общие элементы с указанным массивом
NotOverlap	Сравнение значений на "не пересекается": массив из соединения с данными не имеет общих элементов с указанным массивом
MatchSearch	Сравнение значений на "удовлетворяет поисковой строке": поисковая строка может состоять из слов, разделенных пробелами и знаками "+", "*" и "?", пробел означает "ИЛИ", "+" означает "И", "*" означает любое количество любых символов, "?" означат ровно один символ
NotMatchSearch	Сравнение значений на "не удовлетворяет поисковой строке": поисковая строка может состоять из слов, разделенных пробелами и знаками "+", "*" и "?", пробел означает "ИЛИ", "+" означает "И", "*" означает любое количество любых символов, "?" означат ровно один символ
ContainedIn	Сравнение значений на "входит": значение из соединения с данными входит в указанное значение (значения любых типов данных преобразуются к строковому типу)
NotContainedIn	Сравнение значений на "не входит": значение из соединения с данными не входит в указанное значение (значения любых типов данных преобразуются к строковому типу)

Тэг <And>

Логическое умножение нескольких фильтров.

Необязательный тэг. Значение тэга <And>: список тэгов <Filter>, <And>, <Or> и <Not>.

Атрибуты тэга <And>

RefreshFilter

Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра. Необязательный атрибут. Ожидается логическое значение. Если атрибут RefreshFilter отсутствует, то используется значение True.

Тэг <Or>

Логическое сложение нескольких фильтров.

Необязательный тэг. Значение тэга <Or>: список тэгов <Filter>, <And>, <Or> и <Not>.

Атрибуты тэга <Or>

RefreshFilter

Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра. Необязательный атрибут. Ожидается логическое значение. Если атрибут RefreshFilter отсутствует, то используется значение True.

Тэг <Not>

Логическое отрицание одного фильтра.

Необязательный тэг. Значение тэга <Not>: тэг <Filter>, <And>, <Or> и <Not>.

Атрибуты тэга <Not>

RefreshFilter

Признак, определяющий, будут ли данные сразу же отфильтрованы при изменении вложенного фильтра. Необязательный атрибут. Ожидается логическое значение. Если атрибут RefreshFilter отсутствует, то используется значение True.

Тэг <Field>

Поле, по значению которого полученные данные фильтруются.

Обязательный тэг. Значение тэга <Field>: не ожидается.

Атрибуты тэга <Field>

NativeName

Название поля, по значению которого полученные данные фильтруются. Обязательный атрибут. Ожидается название одного из полей, описанных в тэге <Fields>.

Тэг <Value>

Значение, по которому полученные данные фильтруются.

Обязательный тэг. Ожидается любое значение.

Тэг <DataType>

Тип данных, к которому приводятся сравниваемые значения.

Необязательный тэг. Значение тэга <DataType>: не ожидается.

Если тэг <DataType> отсутствует, то для атрибута Type используется значение StringDataType.

Атрибуты тэга <DataType>

Type	Название типа данных. Обязательный атрибут. Ожидается название одного из типов данных, поддерживаемых формой.

Тэг <Enabled>

Признак, определяющий, будет ли использоваться данный фильтр.

Необязательный тэг. Ожидается логическое значение.

StartPosition

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

Пустое значение или значение меньше 1 соответствуют тому, что строки будут выведены начиная с 1-ой.

Необязательный тэг. Ожидается положительное целочисленное значение.

Если тэг <StartPosition> отсутствует, то используется значение 1.

<StartPosition>1</StartPosition>

MaxCount

Максимальное количество строк, которые будут входить в результирующую таблицу текущего вторичного соединения с данными.

Пустое значение или значение меньше 0 соответствуют тому, что ограничения по количеству строк нет.

Необязательный тэг. Ожидается положительное целочисленное значение.

Если тэг <MaxCount> отсутствует, то используется значение 0.

<MaxCount>100</MaxCount>

Get-проперти для получения свойств

Count

Возвращает количество строк, возвращенных определенным запросом загружающего соединения с данными.

<DataConnection SourceDataConnection="SecondaryGetDataConnectionName">
  <Property Name="Count" />
</DataConnection>