DataSourceSelectArguments.MaximumRows Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellensteuerelement bei einem Datenabrufvorgang zurückgibt, oder legt diesen fest
public:
property int MaximumRows { int get(); void set(int value); };
public int MaximumRows { get; set; }
member this.MaximumRows : int with get, set
Public Property MaximumRows As Integer
Eigenschaftswert
Die maximale Anzahl von Datenzeilen, die eine Datenquelle bei einem Datenabrufvorgang zurückgibt. Der Standardwert ist 0, d. h., alle möglichen Datenzeilen werden zurückgegeben.
Hinweise
Die- MaximumRows Eigenschaft unterstützt Paging-Szenarios. Daten gebundene Steuerelemente überprüfen die-Eigenschaft einer Datenquellen Sicht CanPage zur Laufzeit und fügen DataSourceCapabilities.Page mithilfe der-Methode eine Funktion hinzu, AddSupportedCapabilities(DataSourceCapabilities) Wenn die Ansicht Paging unterstützt. Wenn das Daten gebundene Steuerelement die Funktion nicht hinzufügen kann und die Pagingeigenschaften für ein-Objekt festgelegt werden, das DataSourceSelectArguments während eines Datenabruf Vorgangs an die Datenquellen Sicht übergeben wird, InvalidOperationException wird möglicherweise eine Ausnahme ausgelöst.
Das Daten gebundene Steuerelement kann eine Teilmenge der Daten aus einem Datenquellen-Steuerelement für das Paging anfordern, indem die-Eigenschaft und die-Eigenschaft des StartRowIndex MaximumRows DataSourceSelectArguments an die-Methode übergebenen-Objekts festgelegt werden Select(DataSourceSelectArguments, DataSourceViewSelectCallback)
Wichtig
Wenn eine der DataSourceSelectArguments Eigenschaften festgelegt ist, das gegenwärtig gebundene Datenquellen-Steuerelement jedoch die angeforderte Funktion nicht unterstützt, InvalidOperationException wird beim Aufrufen der-Methode eine Ausnahme ausgelöst DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) .