Freigeben über

DataGridViewRowAccessibleObject.Name Startzeilenindex

  • Artikel

DataGridViewRow.DataGridViewRowAccessibleObject wurde einer Änderung unterzogen, die sich auf die Eigenschaft Name auswirkt. Der Zeilenindex in der Name-Eigenschaft beginnt jetzt standardmäßig bei 1 anstelle von 0.

Als Ergebnis dieser Änderung kündigen Bildschirmsprachausgaben die ausgewählte Zeile einer DataGridView basierend auf einem Anfangsindex von 1 an.

Eingeführt in Version

.NET 9 Preview 1

Vorheriges Verhalten

Zuvor basierte die Name-Eigenschaft auf dem Zeilenindex auf einem Anfangsindex von 0. Sprachausgaben haben die ausgewählte Zeile einer DataGridView basierend auf einem Anfangsindex von 0 angekündigt.

Neues Verhalten

Ab .NET 9 beginnt der Index für die Name-Eigenschaft bei 1. Bildschirmsprachausgaben geben die ausgewählte Zeile einer DataGridView basierend auf einem Anfangsindex von 1 an.

Ändern der Kategorie

Diese Änderung ist eine Verhaltensänderung.

Grund für die Änderung

Diese Änderung behebt ein Problem mit der Barrierefreiheit, das im GitHub-Problem #7154 hervorgehoben wird. Das Problem bezieht sich auf die Zeilenzählung in DataGridViewRow.DataGridViewRowAccessibleObject beginnend bei 0, wodurch eine Diskrepanz mit den Erwartungen der Benutzer und Bildschirmsprachausgaben entsteht.

Durch die Änderung wird eine intuitivere und integrativere Benutzeroberfläche für Benutzer sichergestellt, die auf Bildschirmsprachausgaben und Barrierefreiheitstools angewiesen sind. Sie bietet Entwicklern auch die Flexibilität, das ursprüngliche Verhalten bei Bedarf aufrechtzuerhalten.

Wenn Ihre Anwendung auf das vorherige Verhalten angewiesen ist und Sie den Zeilenindex vorziehen, um mit 0 zu beginnen, können Sie den neuen Schalter System.Windows.Forms.DataGridViewUIAStartRowCountAtZero setzen. Um die ursprüngliche Funktionalität beizubehalten, erstellen Sie eine runtimeconfig.template.json-Datei im Stammordner Ihres Projekts, und legen diesen Schalter auf true fest. Aktualisieren Sie die Codebasis entsprechend, um diese Änderung zu berücksichtigen, und stellen Sie sicher, dass DataGridViewRow.DataGridViewRowAccessibleObject den Zeilenindex mit einem Startpunkt bei 0 anzeigt.

Codeausschnitt einer runtimeconfig.template.json-Datei, die einen Schalter zum vorherigen Verhalten festlegt:

{
    "configProperties": {
      "System.Windows.Forms.DataGridViewUIAStartRowCountAtZero": true
    }
}

Betroffene APIs