Belangrijke wijzigingen in Windows Forms voor .NET Core 3.0 en 3.1

Artikel
12/12/2024

Windows Forms-ondersteuning is toegevoegd aan .NET Core in versie 3.0. In dit artikel vindt u een overzicht van belangrijke wijzigingen voor Windows Forms door de .NET-versie waarin ze zijn geïntroduceerd. Als u een Windows Forms-app bijwerkt van .NET Framework of van een eerdere versie van .NET Core (3.0 of hoger), is dit artikel van toepassing op u.

De volgende belangrijke wijzigingen worden op deze pagina beschreven:

Ingrijpende wijziging	Geïntroduceerde versie
verwijderde besturingselementen	3.1
CellFormatting-gebeurtenis niet getriggerd als een tooltip wordt weergegeven	3.1
Control.DefaultFont werd gewijzigd in Segoe UI 9 pt	3.0
Modernisering van de FolderBrowserDialog-	3.0
SerializableAttribute verwijderd uit sommige typen van Windows Forms	3.0
Compatibiliteitsswitch AllowUpdateChildControlIndexForTabControls wordt niet ondersteund	3.0
DomainUpDown.UseLegacyScrolling-compatibiliteitsswitch wordt niet ondersteund	3.0
De compatibiliteitsswitch DoNotLoadLatestRichEditControl wordt niet ondersteund	3.0
Compatibiliteitsswitch DoNotSupportSelectAllShortcutInMultilineTextBox wordt niet ondersteund	3.0
Compatibiliteitsswitch DontSupportReentrantFilterMessage wordt niet ondersteund	3.0
EnableVisualStyleValidation-compatibiliteitsswitch wordt niet ondersteund	3.0
Compatibiliteitswitch UseLegacyContextMenuStripSourceControlValue niet ondersteund	3.0
UseLegacyImages-compatibiliteitsschakelaar niet ondersteund	3.0
Over- en SplashScreen-sjablonen zijn defect voor Visual Basic	3.0

.NET Core 3.1

Verwijderde bedieningselementen

Vanaf .NET Core 3.1 zijn sommige Besturingselementen voor Windows Forms niet meer beschikbaar.

Beschrijving wijzigen

Vanaf .NET Core 3.1 zijn verschillende Besturingselementen voor Windows Forms niet meer beschikbaar. Vervangende besturingselementen met een beter ontwerp en ondersteuning zijn geïntroduceerd in .NET Framework 2.0. De verouderde controles waren eerder verwijderd uit de ontwerpersgereedschapskisten, maar waren nog steeds beschikbaar om te gebruiken.

De volgende typen zijn niet meer beschikbaar:

Introductie van de versie

3.1

Aanbevolen actie

Elk verwijderd bedieningscontrole heeft een aanbevolen vervangende controle. Raadpleeg de volgende tabel:

Besturingselement verwijderd (API)	Aanbevolen vervanging	Gekoppelde API's die worden verwijderd
Context-menu	ContextmenuStrip
DataGrid	DataGridView	DataGridCell, DataGridRow, DataGridTableCollection, DataGridColumnCollection, DataGridTableStyle, DataGridColumnStyle, DataGridLineStyle, DataGridParentRowsLabel, DataGridParentRowsLabelStyle, DataGridBoolColumn, DataGridTextBox, GridColumnStylesCollection, GridTableStylesCollection, HitTestType
Hoofdmenu	MenuStrip
Keuzemenu	ToolStripDropDown, ToolStripDropDownMenu	Menu-item Collectie
Menu-item	ToolStripMenuItem
Werkbalk	ToolStrip	WerkbalkUiterlijk
Werkbalkknop	ToolStripButton	ToolBarButtonClickEventArgs, ToolBarButtonClickEventHandler, ToolBarButtonStyle, ToolBarTextAlign

Categorie

Windows Forms

Betrokken API's

In een DataGridView worden nu de tekst- en foutrapportage-tooltips van een cel weergegeven wanneer u de muisaanwijzer erboven houdt en wanneer deze is geselecteerd via het toetsenbord. Als er een tooltip wordt weergegeven, wordt de gebeurtenis DataGridView.CellFormatting niet gegenereerd.

Beschrijving wijzigen

Voor .NET Core 3.1 toonde een DataGridView met de eigenschap ShowCellToolTips ingesteld op true een knopinfo voor de tekst en eventuele fouten van een cel wanneer de muisaanwijzer over de cel bewogen werd. Tooltips werden niet weergegeven wanneer een cel werd geselecteerd via het toetsenbord (bijvoorbeeld met de Tab-toets, sneltoetsen of pijlnavigatie). Als de gebruiker een cel heeft bewerkt en de DataGridView zich nog in de bewerkingsmodus bevond, terwijl de muisaanwijzer over een cel zonder de eigenschap ToolTipText zweefde, werd er een CellFormatting-gebeurtenis gegenereerd om de celtekst op te maken voor weergave.

Om te voldoen aan de toegankelijkheidsstandaarden, toont vanaf .NET Core 3.1 een DataGridView met de eigenschap ShowCellToolTips ingesteld op true knopinfo voor de tekst en fouten van een cel, zowel wanneer de cel wordt aangewezen als wanneer deze wordt geselecteerd via het toetsenbord. Als gevolg van deze wijziging wordt de CellFormatting-gebeurtenis niet gegenereerd wanneer cellen die niet de eigenschap ToolTipText ingesteld hebben worden benaderd terwijl de DataGridView in de bewerkingsmodus staat. De gebeurtenis wordt niet gegenereerd omdat de inhoud van de zwevende cel wordt weergegeven als knopinfo in plaats van in de cel te worden weergegeven.

Versie geïntroduceerd

3.1

Aanbevolen actie

Herstructureer alle code die afhankelijk is van de CellFormatting gebeurtenis terwijl de DataGridView zich in de bewerkingsmodus bevindt.

Categorie

Windows Forms

Getroffen API's

Geen

.NET Core 3.0

Standaardlettertype voor besturingselementen gewijzigd in Segoe UI 9 pt

Beschrijving wijzigen

In .NET Framework is de eigenschap Control.DefaultFont ingesteld op Microsoft Sans Serif 8.25 pt. In de volgende afbeelding ziet u een venster waarin het standaardlettertype wordt gebruikt.

standaardlettertype voor besturingselementen in .NET Framework

Vanaf .NET Core 3.0 is het standaardlettertype ingesteld op Segoe UI 9 pt (hetzelfde lettertype als SystemFonts.MessageBoxFont). Als gevolg van deze wijziging zijn formulieren en besturingselementen ongeveer 27% groter om rekening te houden met de grotere grootte van het nieuwe standaardlettertype. Bijvoorbeeld:

Standaardlettertype voor controls in .NET Core

Deze wijziging is aangebracht in overeenstemming met UX-richtlijnen (Windows-gebruikerservaring).

Versie uitgebracht

3.0

Aanbevolen actie

Vanwege de wijziging in de grootte van formulieren en besturingselementen moet u ervoor zorgen dat uw toepassing correct wordt weergegeven.

Als u het oorspronkelijke lettertype voor één formulier wilt behouden, stelt u het standaardlettertype in op Microsoft Sans Serif 8.25 pt. Bijvoorbeeld:

public MyForm()
{
    InitializeComponent();
    Font = new Font(new FontFamily("Microsoft Sans Serif"), 8.25f);
}

U kunt ook het standaardlettertype voor een hele toepassing op een van de volgende manieren wijzigen:

Door de eigenschap ApplicationDefaultFont MSBuild in te stellen op 'Microsoft Sans Serif, 8.25pt'. Dit is de voorkeurstechniek omdat Visual Studio de nieuwe instellingen in de ontwerpfunctie kan gebruiken.
```
<PropertyGroup>
  <ApplicationDefaultFont>Microsoft Sans Serif, 8.25pt</ApplicationDefaultFont>
</PropertyGroup>
```

Door Application.SetDefaultFont(Font)aan te roepen.

class Program
{
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.SetHighDpiMode(HighDpiMode.SystemAware);
        Application.SetDefaultFont(new Font(new FontFamily("Microsoft Sans Serif"), 8.25f));
        Application.Run(new Form1());
    }
}

Categorie

Windows Forms

Betrokken API's

Geen.

Modernisering van de FolderBrowserDialog

Het besturingselement FolderBrowserDialog is gewijzigd in Windows Forms-toepassingen voor .NET Core.

Beschrijving wijzigen

In .NET Framework worden in Windows-formulieren het volgende dialoogvenster gebruikt voor het besturingselement FolderBrowserDialog:

FolderBrowserDialogControl in de .NET Framework-

In .NET Core 3.0 maakt Windows Forms gebruik van een nieuwere COM-besturingselement dat is geïntroduceerd in Windows Vista:

De FolderBrowserDialogControl in .NET Core

Versie geïntroduceerd

3.0

Aanbevolen actie

Het dialoogvenster wordt automatisch bijgewerkt.

Als u het oorspronkelijke dialoogvenster wilt behouden, stelt u de eigenschap FolderBrowserDialog.AutoUpgradeEnabled in op false voordat u het dialoogvenster weergeeft, zoals wordt geïllustreerd door het volgende codefragment:

var dialog = new FolderBrowserDialog();
dialog.AutoUpgradeEnabled = false;
dialog.ShowDialog();

Categorie

Windows Forms

Getroffen API's

FolderBrowserDialog

SerializableAttribute verwijderd uit sommige types van Windows Forms

De SerializableAttribute is verwijderd uit sommige Windows Forms-klassen die geen bekende binaire serialisatiescenario's hebben.

Beschrijving wijzigen

De volgende typen zijn gedecoreerd met de SerializableAttribute in .NET Framework, maar het attribuut is verwijderd in .NET Core.

System.InvariantComparer
System.ComponentModel.Design.ExceptionCollection
System.ComponentModel.Design.Serialization.CodeDomSerializerException
System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.CodeDomSerializationStore
System.Drawing.Design.ToolboxItem
System.Resources.ResXNullRef
System.Resources.ResXDataNode
System.Resources.ResXFileRef
System.Windows.Forms.Cursor
System.Windows.Forms.NativeMethods.MSOCRINFOSTRUCT
System.Windows.Forms.NativeMethods.MSG

Dit serialisatiemechanisme heeft in het verleden ernstige onderhouds- en beveiligingsproblemen gehad. Het behoud van SerializableAttribute op typen betekent dat deze typen moeten worden getest op serialisatiewijzigingen van versie tot versie en mogelijk op serialisatiewijzigingen van framework tot framework. Dit maakt het moeilijker om deze typen te ontwikkelen en kan kostbaar zijn om te onderhouden. Deze typen hebben geen bekende binaire serialisatiescenario's, waardoor de impact van het verwijderen van het kenmerk wordt geminimaliseerd.

Zie Binaire serialisatievoor meer informatie.

Versie uitgebracht

3.0

Aanbevolen actie

Werk alle code bij die afhankelijk kan zijn van deze typen die als serialiseerbaar worden gemarkeerd.

Categorie

Windows Forms

Betrokken API's

Geen

Compatibiliteitsswitch AllowUpdateChildControlIndexForTabControls wordt niet ondersteund

De Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls compatibiliteitsswitch wordt ondersteund in Windows Forms op .NET Framework 4.6 en nieuwere versies, maar wordt niet ondersteund op .NET Core of .NET 5.0 en hoger.

Beschrijving wijzigen

Als u in .NET Framework 4.6 en hoger een tabblad selecteert, wordt de verzameling van besturingselementen opnieuw gerangschikt. Met de Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls compatibiliteitsswitch kan een toepassing deze volgorde overslaan wanneer dit gedrag ongewenst is.

In .NET Core en .NET 5.0 en hoger wordt de Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls-switch niet ondersteund.

Nieuwe versie geïntroduceerd

3.0

Aanbevolen actie

Verwijder de schakelaar. De switch wordt niet ondersteund en er is geen alternatieve functionaliteit beschikbaar.

Categorie

Windows Forms

Getroffen API's

Geen

Compatibiliteitsswitch DomainUpDown.UseLegacyScrolling wordt niet ondersteund

De Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling compatibiliteitsswitch, die is geïntroduceerd in .NET Framework 4.7.1, wordt niet ondersteund in Windows Forms op .NET Core of .NET 5.0 en hoger.

Beschrijving wijzigen

Vanaf .NET Framework 4.7.1 heeft de Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling compatibiliteitsswitch ontwikkelaars toegestaan om onafhankelijke DomainUpDown.DownButton()- en DomainUpDown.UpButton() acties uit te schakelen. De schakelaar heeft het oorspronkelijke gedrag hersteld, waarbij de DomainUpDown.UpButton() wordt genegeerd als er contexttekst aanwezig is en de ontwikkelaar verplicht is de DomainUpDown.DownButton()-actie op het besturingselement uit te voeren vóór de DomainUpDown.UpButton()-actie. Zie <AppContextSwitchOverrides> elementvoor meer informatie.

In .NET Core en .NET 5.0 en hoger wordt de Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling-switch niet ondersteund.

Geïntroduceerde versie

3.0

Aanbevolen actie

Verwijder de schakelaar. De switch wordt niet ondersteund en er is geen alternatieve functionaliteit beschikbaar.

Categorie

Windows Forms

Geen

Over- en SplashScreen-sjablonen zijn verbroken

De About.vb- en SplashScreen.vb-bestanden die door Visual Studio worden gegenereerd, bevatten verwijzingen naar typen in de My naamruimte die niet beschikbaar zijn .NET Core 3.0 en 3.1.

Ingevoerde versie

3.0

Beschrijving wijzigen

.NET Core 3.0 en 3.1 bevatten geen volledige ondersteuning voor Visual Basic My. De Over en SplashScreen formuliersjablonen in Visual Studio voor Visual Basic Windows Forms-apps verwijzen naar eigenschappen van het My.Application.Info-type die niet beschikbaar zijn.

Aanbevolen actie

Visual Basic My ondersteuning is verbeterd in .NET 5, uw project upgraden naar .NET 5 of hoger.

-of-

Los de compilerfouten op in de About en SplashScreen typen in uw app. Gebruik de System.Reflection.Assembly-klasse om de informatie op te halen die wordt verstrekt door het My.Application.Info type. Hier is een directe versie van beide vormen beschikbaar.

Tip

Dit is voorbeeldcode en niet-geoptimaliseerd. De lijst met kenmerken moet in de cache worden opgeslagen om de laadtijd van formulieren te verminderen.

Over

Imports System.Reflection

Public NotInheritable Class About

    Private Sub about_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        ' Set the title of the form.
        Dim applicationTitle As String = Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyTitleAttribute)()?.Title

        If String.IsNullOrEmpty(applicationTitle) Then
            applicationTitle = System.IO.Path.GetFileNameWithoutExtension(Assembly.GetExecutingAssembly().GetName().Name)
        End If

        Me.Text = String.Format("About {0}", applicationTitle)
        ' Initialize all of the text displayed on the About Box.
        ' TODO: Customize the application's assembly information in the "Application" pane of the project
        '    properties dialog (under the "Project" menu).
        Me.LabelProductName.Text = If(Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyProductAttribute)()?.Product, "")
        Me.LabelVersion.Text = String.Format("Version {0}", Assembly.GetExecutingAssembly().GetName().Version)
        Me.LabelCopyright.Text = If(Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyCopyrightAttribute)()?.Copyright, "")
        Me.LabelCompanyName.Text = If(Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyCompanyAttribute)()?.Company, "")
        Me.TextBoxDescription.Text = If(Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyDescriptionAttribute)()?.Description, "")
    End Sub

    Private Sub OKButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles OKButton.Click
        Me.Close()
    End Sub

End Class

SplashScreen

Imports System.Reflection

Public NotInheritable Class SplashScreen

    Private Sub SplashScreen1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
        'Set up the dialog text at runtime according to the application's assembly information.  

        'TODO: Customize the application's assembly information in the "Application" pane of the project
        '  properties dialog (under the "Project" menu).

        'Application title
        Dim appTitle As String = Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyTitleAttribute)()?.Title

        If String.IsNullOrEmpty(appTitle) Then
            appTitle = System.IO.Path.GetFileNameWithoutExtension(Assembly.GetExecutingAssembly().GetName().Name)
        End If

        ApplicationTitle.Text = appTitle

        Dim versionValue = Assembly.GetExecutingAssembly().GetName().Version

        'Format the version information using the text set into the Version control at design time as the
        '  formatting string.  This allows for effective localization if desired.
        '  Build and revision information could be included by using the following code and changing the
        '  Version control's designtime text to "Version {0}.{1:00}.{2}.{3}" or something similar.  See
        '  String.Format() in Help for more information.
        '
        '    Version.Text = System.String.Format(Version.Text, versionValue.Major, versionValue.Minor, versionValue.Build, versionValue.Revision)

        Version.Text = System.String.Format(Version.Text, versionValue.Major, versionValue.Minor)

        'Copyright info
        Copyright.Text = If(Assembly.GetExecutingAssembly().GetCustomAttribute(Of AssemblyCopyrightAttribute)()?.Copyright, "")
    End Sub

End Class

Categorie

Visual Basic Windows Forms

Getroffen API's

Geen

Zie ook

een Windows Forms-app overzetten naar .NET Core

Delen via

Belangrijke wijzigingen in Windows Forms voor .NET Core 3.0 en 3.1

.NET Core 3.1

Verwijderde bedieningselementen

Beschrijving wijzigen

Introductie van de versie

Aanbevolen actie

Categorie

Betrokken API's

De CellFormatting-gebeurtenis wordt niet geactiveerd als een tooltip wordt weergegeven

Beschrijving wijzigen

Versie geïntroduceerd

Aanbevolen actie

Categorie

Getroffen API's

.NET Core 3.0

Standaardlettertype voor besturingselementen gewijzigd in Segoe UI 9 pt

Beschrijving wijzigen

Versie uitgebracht

Aanbevolen actie

Categorie

Betrokken API's

Modernisering van de FolderBrowserDialog

Beschrijving wijzigen

Versie geïntroduceerd

Aanbevolen actie

Categorie

Getroffen API's

SerializableAttribute verwijderd uit sommige types van Windows Forms

Beschrijving wijzigen

Versie uitgebracht

Aanbevolen actie

Categorie

Betrokken API's

Compatibiliteitsswitch AllowUpdateChildControlIndexForTabControls wordt niet ondersteund

Beschrijving wijzigen

Nieuwe versie geïntroduceerd

Aanbevolen actie

Categorie

Getroffen API's

Compatibiliteitsswitch DomainUpDown.UseLegacyScrolling wordt niet ondersteund

Beschrijving wijzigen

Geïntroduceerde versie

Aanbevolen actie

Categorie

Getroffen API's

Compatibiliteitsswitch DoNotLoadLatestRichEditControl wordt niet ondersteund

Beschrijving wijzigen

Versie uitgebracht

Aanbevolen actie

Categorie

Getroffen API's

De compatibiliteitsswitch DoNotSupportSelectAllShortcutInMultilineTextBox wordt niet ondersteund

Beschrijving wijzigen

Nieuwe versie geïntroduceerd

Aanbevolen actie

Categorie

Getroffen API's

Compatibiliteitsswitch DontSupportReentrantFilterMessage wordt niet ondersteund

Beschrijving wijzigen

Ingevoerde versie

Aanbevolen actie

Categorie

Getroffen API's

EnableVisualStyleValidation-compatibiliteitsswitch wordt niet ondersteund

Beschrijving wijzigen

Versie geïntroduceerd

Aanbevolen actie

Categorie

Getroffen API's

Compatibiliteitsschakelaar UseLegacyContextMenuStripSourceControlValue niet ondersteund

Beschrijving wijzigen

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

De compatibiliteitsschakelaar UseLegacyImages wordt niet ondersteund

Beschrijving wijzigen

Versie geïntroduceerd

Aanbevolen actie