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.
Dient zum Abrufen oder Festlegen eines Werts, der die maximale Anzahl von Datenzeilen darstellt, die ein Datenquellensteuerelement für einen Datenempfangsvorgang zurückgibt.
public:
property int MaximumRows { int get(); void set(int value); };public int MaximumRows { get; set; }member this.MaximumRows : int with get, setPublic Property MaximumRows As IntegerEigenschaftswert
Die maximale Anzahl von Datenzeilen, die eine Datenquelle für einen Datenempfangsvorgang zurückgibt. Der Standardwert ist 0, der angibt, dass alle möglichen Datenzeilen zurückgegeben werden.
Hinweise
Die MaximumRows Eigenschaft unterstützt Pagingszenarien. Datengebundene Steuerelemente überprüfen die Eigenschaft einer Datenquellenansicht CanPage zur Laufzeit und fügen eine DataSourceCapabilities.Page Funktion mithilfe der AddSupportedCapabilities(DataSourceCapabilities) Methode hinzu, wenn die Ansicht paging unterstützt. Wenn das datengebundene Steuerelement die Funktion nicht hinzufügen kann und die Auslagerungseigenschaften für ein DataSourceSelectArguments Objekt festgelegt werden, das während eines Datenempfangsvorgangs an die Datenquellenansicht übergeben wird, wird möglicherweise eine InvalidOperationException Ausnahme ausgelöst.
Das datengebundene Steuerelement kann eine Teilmenge von Daten aus einem Datenquellensteuerelement für die Auslagerung anfordern, indem die StartRowIndex Eigenschaften des Objekts festgelegt werden MaximumRows , das DataSourceSelectArguments an die Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Methode übergeben wird.
Von Bedeutung
Wenn eine der DataSourceSelectArguments Eigenschaften festgelegt ist, aber das aktuell gebundene Datenquellensteuerelement die angeforderte Funktion nicht unterstützt, wird eine InvalidOperationException Ausnahme ausgelöst, wenn die DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) Methode aufgerufen wird.
