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

Artikel
10/04/2023

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:

Wijziging die fouten veroorzaken	Versie geïntroduceerd
Verwijderde besturingselementen	3.1
De gebeurtenis CellFormatting wordt niet gegenereerd als knopinfo wordt weergegeven	3.1
Control.DefaultFont is gewijzigd in Segoe UI 9 pt	3,0
Modernisering van de FolderBrowserDialog	3,0
SerializableAttribute verwijderd uit sommige Typen Windows Forms	3,0
Compatibiliteitsswitch AllowUpdateChildControlIndexForTabControls wordt niet ondersteund	3,0
Compatibiliteitsswitch DomainUpDown.UseLegacyScrolling wordt niet ondersteund	3,0
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
CompatibiliteitsswitchLegacyContextMenuStripSourceControlValue niet ondersteund	3,0
CompatibiliteitsswitchLegacyImages gebruiken wordt niet ondersteund	3,0
Over- en SplashScreen-sjablonen zijn verbroken voor Visual Basic	3,0

.NET Core 3.1

Verwijderde besturingselementen

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

Wijzigingsbeschrijving

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 afgeschafte besturingselementen zijn eerder verwijderd uit designer-werksets, maar waren nog steeds beschikbaar om te worden gebruikt.

De volgende typen zijn niet meer beschikbaar:

Versie geïntroduceerd

3.1

Aanbevolen actie

Elk verwijderd besturingselement heeft een aanbevolen vervangingsbeheer. Raadpleeg de volgende tabel:

Besturingselement verwijderd (API)	Aanbevolen vervanging	Gekoppelde API's die worden verwijderd
ContextMenu	ContextmenuStrip
Datagrid	Datagridview	DataGridCell, DataGridRow, DataGridTableCollection, DataGridColumnCollection, DataGridTableStyle, DataGridColumnStyle, DataGridLineStyle, DataGridParentRowsLabel, DataGridParentRowsLabelStyle, DataGridBoolColumn, DataGridTextBox, GridColumnStylesCollection, GridTableStylesCollection, HitTestType
Hoofdmenu	MenuStrip
Menu	ToolStripDropDown, Menu ToolStripDropDown	MenuItemCollection
Menuitem	ToolStripMenuItem
Werkbalk	Werkbalk	ToolBarAppearance
Knopknop	ToolStripButton	ToolBarButtonClickEventArgs, ToolBarButtonClickEventHandler, ToolBarButtonStyle, ToolBarTextAlign

Categorie

Windows Forms

Betrokken API's

A DataGridView toont nu de tekst en foutknopinfo van een cel wanneer u de muisaanwijzer aanwijst en wanneer deze is geselecteerd via het toetsenbord. Als er knopinfo wordt weergegeven, wordt de DataGridView.CellFormatting gebeurtenis niet gegenereerd.

Wijzigingsbeschrijving

Voorafgaand aan .NET Core 3.1, waarop DataGridView de ShowCellToolTips eigenschap is ingesteld om knopinfo weer te true geven voor de tekst en fouten van een cel toen de cel werd aangeroepen door een muis. Knopinfo is niet weergegeven wanneer een cel is geselecteerd via het toetsenbord (bijvoorbeeld met de Tab-toets, sneltoetsen of pijlnavigatie). Als de gebruiker een cel heeft bewerkt en terwijl de DataGridView bewerkingsmodus nog in de bewerkingsmodus stond, heeft u de muisaanwijzer boven een cel geplaatst waarvoor de ToolTipText eigenschap niet is ingesteld, een CellFormatting gebeurtenis gegenereerd om de tekst van de cel op te maken voor weergave in de cel.

Als u wilt voldoen aan de toegankelijkheidsstandaarden, begint u in .NET Core 3.1, een DataGridView eigenschap die is ShowCellToolTips ingesteld om knopinfo weer te true geven voor de tekst en fouten van een cel, niet alleen wanneer de cel wordt aangezet, maar ook wanneer deze is geselecteerd via het toetsenbord. Als gevolg van deze wijziging wordt de CellFormatting gebeurtenis niet gegenereerd wanneer cellen die niet over de ToolTipText eigenschappenset beschikken, worden aangezet terwijl de DataGridView bewerkingsmodus is ingeschakeld. 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 deze zich in de DataGridView bewerkingsmodus bevindt.

Categorie

Windows Forms

Betrokken API's

Geen

.NET Core 3.0

Standaardlettertype voor besturingselementen gewijzigd in Segoe UI 9 pt

Wijzigingsbeschrijving

In .NET Framework is de Control.DefaultFont eigenschap 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. Voorbeeld:

Standaardlettertype voor besturingselementen in .NET Core

Deze wijziging is aangebracht om te voldoen aan de richtlijnen voor Windows-gebruikerservaring (UX).

Versie geïntroduceerd

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 Microsoft Sans Serif 8.25 ptin op . Voorbeeld:

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 ApplicationDefaultFont eigenschap 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 te bellen Application.SetDefaultFont(Font).

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 FolderBrowserDialog besturingselement is gewijzigd in Windows Forms-toepassingen voor .NET Core.

Wijzigingsbeschrijving

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

De FolderBrowserDialogControl in .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 FolderBrowserDialog.AutoUpgradeEnabled eigenschap false in op 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

Betrokken API's

FolderBrowserDialog

SerializableAttribute verwijderd uit sommige Typen Windows Forms

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

Wijzigingsbeschrijving

De volgende typen zijn ingericht met het SerializableAttribute in .NET Framework, maar het kenmerk 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. Onderhouden van SerializableAttribute typen betekent dat deze typen moeten worden getest op serialisatiewijzigingen van versie-naar-versie en mogelijk serialisatiewijzigingen van framework-naar-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 serialisatie voor meer informatie.

Versie geïntroduceerd

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 hoger, maar wordt niet ondersteund op .NET Core of .NET 5.0 en hoger.

Wijzigingsbeschrijving

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.

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

Betrokken 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.

Wijzigingsbeschrijving

Vanaf .NET Framework 4.7.1 konden ontwikkelaars zich met de Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling compatibiliteitsswitch afmelden voor onafhankelijke DomainUpDown.DownButton() acties en DomainUpDown.UpButton() acties. Met de schakeloptie is het verouderde gedrag hersteld, waarbij de tekst van de DomainUpDown.UpButton() context wordt genegeerd en de ontwikkelaar actie moet uitvoeren DomainUpDown.DownButton() op het besturingselement voordat de DomainUpDown.UpButton() actie wordt uitgevoerd. Zie <het element AppContextSwitchOverrides> voor meer informatie.

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

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

Geen

Over- en SplashScreen-sjablonen zijn verbroken

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

Versie geïntroduceerd

3,0

Wijzigingsbeschrijving

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

Aanbevolen actie

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

– of –

Los de compilerfouten op in de typen About en SplashScreen in uw app. Gebruik de System.Reflection.Assembly klasse om de informatie op te halen die door het My.Application.Info type wordt verstrekt. Hier is een rechte poort van beide formulieren 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.

Info

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

Betrokken API's

None

Zie ook

Een Windows Forms-app overzetten naar .NET Core

Share via

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

.NET Core 3.1

Verwijderde besturingselementen

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

De gebeurtenis CellFormatting wordt niet gegenereerd als knopinfo wordt weergegeven

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

.NET Core 3.0

Standaardlettertype voor besturingselementen gewijzigd in Segoe UI 9 pt

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

Modernisering van de FolderBrowserDialog

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

SerializableAttribute verwijderd uit sommige Typen Windows Forms

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

Compatibiliteitsswitch AllowUpdateChildControlIndexForTabControls wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

Compatibiliteitsswitch DomainUpDown.UseLegacyScrolling wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

Compatibiliteitsswitch DoNotLoadLatestRichEditControl wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

Compatibiliteitsswitch DoNotSupportSelectAllShortcutInMultilineTextBox wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

Compatibiliteitsswitch DontSupportReentrantFilterMessage wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

EnableVisualStyleValidation-compatibiliteitsswitch wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

CompatibiliteitsswitchLegacyContextMenuStripSourceControlValue niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie

Categorie

Betrokken API's

CompatibiliteitsswitchLegacyImages gebruiken wordt niet ondersteund

Wijzigingsbeschrijving

Versie geïntroduceerd

Aanbevolen actie