DoCmd.SetOrderBy-Methode (Access)

Mit der SetOrderBy-Methode können Sie das aktive Datenblatt, das aktive Formular, den aktiven Bericht oder die aktuelle Tabelle sortieren.

Syntax

Ausdruck. SetOrderBy (OrderBy, ControlName)

expression Eine Variable, die ein DoCmd-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
OrderBy	Erforderlich	Variant	Ein Zeichenfolgenausdruck, der den Namen des Felds oder die Namen der Felder zum Sortieren der Datensätze und die optionalen Schlüsselwörter ASC oder DESC enthält.
ControlName	Optional	Variant	Wenn angegeben und das aktive Objekt ein Formular oder Bericht ist, der Name des Steuerelements, das dem zu sortierenden Unterformular oder Unterbericht entspricht. Wenn leer und das aktive Objekt ein Formular oder bericht ist, wird das übergeordnete Formular oder der übergeordnete Bericht sortiert.

HinwBemerkungeneise

Wenn Sie diese Methode ausführen, wird die Sortierung auf die Tabelle, das Formular, den Bericht oder das Datenblatt (z. B. das Abfrageergebnis) angewendet, die aktiv ist und den Fokus hat.

Das Argument OrderBy ist der Name des Felds oder der Felder, nach denen Sie Datensätze sortieren möchten. Wenn Sie mehr als einen Feldnamen verwenden, trennen Sie die Namen durch ein Komma (,). Die SortiertNach -Eigenschaft des aktiven Objekts wird verwendet, um einen Sortierwert zu speichern, den Sie später anwenden können. OrderBy -Werte werden mit den Objekten gespeichert, in denen sie erstellt werden. Sie werden zwar automatisch geladen, wenn das Objekt geöffnet wird, aber werden nicht automatisch angewendet.

Wenn Sie das Argument OrderBy festlegen, indem Sie einen oder mehrere Feldnamen eingeben und dann die -Methode ausführen, werden die Datensätze standardmäßig in aufsteigender Reihenfolge sortiert.

Um Datensätze in absteigender Reihenfolge zu sortieren, geben Sie AM Ende des OrderBy-Argumentausdrucks DESC ein. Wenn Sie beispielsweise Kundendatensätze in absteigender Reihenfolge nach Kontaktname sortieren möchten, legen Sie das Argument OrderBy auf "ContactName DESC" fest. Wenn Sie Namen nach absteigender Nachname und Aufsteigender Vorname sortieren möchten, legen Sie das OrderBy-Argument auf "LastName DESC, FirstName ASC" fest.

Beispiel

Im folgenden Codebeispiel wird das aktive Datenblatt, das formular, der Bericht oder die Tabelle nach absteigender Name und aufsteigender Vorname sortiert.

DoCmd.SetOrderBy "LastName DESC, FirstName ASC"

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.