FireDAC.Comp.DataSet.TFDDataSet.AddIndex

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure AddIndex(const AName, AFields, AExpression: string; AOptions: TFDSortOptions;  const ADescFields: string = ''; const ACaseInsFields: string = ''; ADistinct: Boolean = False);

C++

void __fastcall AddIndex(const System::UnicodeString AName, const System::UnicodeString AFields, const System::UnicodeString AExpression, Firedac::Stan::Intf::TFDSortOptions AOptions, const System::UnicodeString ADescFields = System::UnicodeString(), const System::UnicodeString ACaseInsFields = System::UnicodeString(), bool ADistinct = false);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet


Beschreibung

Erstellt einen neuen Client-Index für die Datenmenge.

Rufen Sie AddIndex auf, um einen neuen Index für die Client-Datenmenge zu erstellen. 

Diese Methode entspricht dem manuellen Hinzufügen eines neuen Index zu der Eigenschaft Indexes und dem Setzen der Eigenschaften des neuen Index. Ist der Index mit dem Namen AName bereits vorhanden, wird eine Exception ausgelöst.

Die Eigenschaften AField und AExpression schließen sich gegenseitig aus. Der neue Index ist aktiv aber nicht aktuell.

Bedeutung der Parameter:

  • AName - Ein Name des neuen Index.
  • AFields - Eine durch Semikolon getrennte Liste der Felder, die in den Index einbezogen werden sollen.
  • AExpression - Ein Sortierausdruck.
  • AOptions - Eine Reihe zusätzlicher Optionen für den Index.
  • ADescFields - Eine durch Semikolon getrennte Liste von Feldnamen. Mit ADescFields anstatt eines AOptions-Werts, der soDescending enthält, erstellen Sie einen Index, der einige Felder in aufsteigender Reihenfolge und andere Felder in absteigender Reihenfolge sortiert. Alle Felder, deren Namen in ADescFields angegeben sind, werden in absteigender Reihenfolge sortiert.
  • ACaseInsFields - Eine durch Semikolon getrennte Liste von Feldnamen. Mit ACaseInsFields anstatt eines AOptions-Werts, der soNoCase enthält, erstellen Sie einen Index, der die Groß-/Kleinschreibung für einige Felder beachtet und sie für andere Felder nicht beachtet. Alle Felder, deren Namen in ACaseInsFields angegeben sind, werden ohne Beachtung der Groß-/Kleinschreibung sortiert.
  • ADistinct - True, wenn Sie nur Datensätze mit unterschiedlichen AFields/AExpression-Werten benötigen. False, wenn Sie alle Datensätze benötigen. False ist der Standardwert.

Siehe auch