A Windows Forms for .NET Core 3.0 és 3.1 kompatibilitástörő változásai

Cikk
12/11/2024

A Windows Forms támogatása a 3.0-s verzióban lett hozzáadva a .NET Core-hoz. Ez a cikk felsorolja a Windows Forms azon töréseit, amelyeket a .NET azon verziója hozott be, amelyikben bevezették őket. Ha Windows Forms-alkalmazást frissít a .NET-keretrendszerről vagy a .NET Core egy korábbi verziójáról (3.0 vagy újabb), ez a cikk vonatkozik Önre.

A következő kompatibilitástörő változások dokumentálva vannak ezen a lapon:

Kompatibilitástörő változás	Bevezetett verzió
Eltávolított vezérlők	3.1
CellFormatting esemény nem jelenik meg, ha az elemleírás megjelenik	3.1
Control.DefaultFont megváltozott Segoe UI 9 pt-ra	3.0
FolderBrowserDialog modernizálása	3.0
A SerializableAttribute eltávolításra került néhány Windows Forms-típusból	3.0
AllowUpdateChildControlIndexForTabControls kompatibilitási kapcsoló nem támogatott	3.0
DomainUpDown.UseLegacyScrolling kompatibilitási kapcsoló nem támogatott	3.0
DoNotLoadLatestRichEditControl kompatibilitási kapcsoló nem támogatott	3.0
DoNotSupportSelectAllShortcutInMultilineTextBox kompatibilitási kapcsoló nem támogatott	3.0
DontSupportReentrantFilterMessage kompatibilitási kapcsoló nem támogatott	3.0
EnableVisualStyleValidation kompatibilitási kapcsoló nem támogatott	3.0
UseLegacyContextMenuStripSourceControlValue kompatibilitási kapcsoló nem támogatott	3.0
UseLegacyImages kompatibilitási kapcsoló nem támogatott	3.0
A Visual Basic névjegy- és SplashScreen-sablonjai hibásak	3.0

.NET Core 3.1

Eltávolított vezérlők

A .NET Core 3.1-től kezdve bizonyos Windows Forms-vezérlők már nem érhetők el.

Leírás módosítása

A .NET Core 3.1-től kezdve a Windows Forms különböző vezérlői már nem érhetők el. A jobb kialakítású és támogatott cserevezérlőket a .NET-keretrendszer 2.0-s verziója vezette be. Az elavult vezérlőket korábban eltávolították a tervezőeszközkészletekből, de továbbra is használhatók voltak.

A következő típusok már nem érhetők el:

Bevezetett verzió

3.1

Javasolt művelet

Minden eltávolított vezérlő ajánlott cserevezérlővel rendelkezik. Tekintse meg a következő táblázatot:

Eltávolított vezérlő (API)	Javasolt csere	Eltávolított társított API-k
ContextMenu	ContextMenuStrip
DataGrid	DataGridView	DataGridCell, DataGridRow, DataGridTableCollection, DataGridColumnCollection, DataGridTableStyle, DataGridColumnStyle, DataGridLineStyle, DataGridParentRowsLabel, DataGridParentRowsLabelStyle, DataGridBoolColumn, DataGridTextBox, GridColumnStylesCollection, GridTableStylesCollection, HitTestType
Főmenü	MenuStrip
Menü	ToolStripDropDown, ToolStripDropDownMenu	MenuElemGyűjtemény
Menüelem	ToolStripMenuItem
Eszközsáv	ToolStrip	Eszköztár megjelenés
Eszköztársáv gomb	Eszköztár gomb	ToolBarButtonClickEventArgs, ToolBarButtonClickEventHandler, ToolBarButtonStyle, ToolBarTextAlign

Kategória

Windows Forms

Érintett API-k

A DataGridView mostantól egy cella szövegét és hibaüzeneteket jeleníti meg, ha egérrel rámutat, és billentyűzettel van kijelölve. Ha eszköztipp jelenik meg, a DataGridView.CellFormatting esemény nem aktiválódik.

Leírás módosítása

A .NET Core 3.1-et megelőzően egy DataGridView, amelynél a ShowCellToolTips tulajdonság true volt beállítva, elemleírást mutatott egy cella szövegéhez és hibáihoz, amikor a cellát egérrel mozgatta. Az elemleírások nem jelennek meg, amikor egy cella ki van jelölve a billentyűzeten keresztül (például a Tab billentyűvel, a billentyűparancsokkal vagy a nyílnavigációval). Ha a felhasználó szerkesztett egy cellát, majd amíg a DataGridView még szerkesztési módban volt, egy olyan cellára mutatott, amely nem rendelkezik a ToolTipText tulajdonságkészlettel, egy CellFormatting esemény történt, amely formázza a cella szövegét a cellában való megjelenítéshez.

Annál, hogy megfeleljen az akadálymentességi szabványoknak, a .NET Core 3.1-től kezdődően egy DataGridView esetén, amikor a ShowCellToolTips tulajdonsága true-re van állítva, a cella szövegének és hibáinak elemleírásai nem csak a cella fölé mutatásakor, hanem a billentyűzeten keresztüli kijelöléskor is megjelennek. A változás következtében a CellFormatting esemény nem , amikor a ToolTipText tulajdonságot nem tartalmazó cellák fölé visszük az egérmutatót, miközben a DataGridView szerkesztési módban van. Az esemény nem merül fel, mert a rámutatott cella tartalma elemleírásként jelenik meg a cellában való megjelenítés helyett.

Bevezetett verzió

3.1

Javasolt művelet

Refaktoráljon bármely kódot, ami a CellFormatting eseménytől függ, miközben a DataGridView szerkesztési módban van.

Kategória

Windows Forms

Érintett API-k

Egyik sem

.NET Core 3.0

Alapértelmezett vezérlőelem betűtípusa Segoe UI 9 pt-ra módosult

Leírás módosítása

A .NET-keretrendszerben a Control.DefaultFont tulajdonság Microsoft Sans Serif 8.25 ptlett beállítva. Az alábbi képen az alapértelmezett betűtípust használó ablak látható.

.NET-keretrendszer alapértelmezett vezérlőelem-betűtípusa

A .NET Core 3.0-tól kezdve az alapértelmezett betűtípus Segoe UI 9 pt (ugyanaz, mint SystemFonts.MessageBoxFont). A változás eredményeként az űrlapok és vezérlők mérete körülbelül 27% nagyobb, hogy figyelembe vegyék az új alapértelmezett betűtípus nagyobb méretét. Például:

alapértelmezett vezérlőelem betűtípusa a .NET Core

Ez a módosítás Windows felhasználói felület (UX)irányelveivel összhangban történt.

Bevezetett verzió

3.0

Javasolt művelet

Az űrlapok és vezérlők méretének változása miatt győződjön meg arról, hogy az alkalmazás megfelelően jelenik meg.

Ha egyetlen űrlap eredeti betűtípusát szeretné megőrizni, állítsa az alapértelmezett betűtípust Microsoft Sans Serif 8.25 ptértékre. Például:

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

A teljes alkalmazás alapértelmezett betűtípusát az alábbi módokon is módosíthatja:

Ha a ApplicationDefaultFont MSBuild tulajdonságot "Microsoft Sans Serif, 8.25pt" értékre állítja. Ez az előnyben részesített technika, mivel lehetővé teszi a Visual Studio számára, hogy a tervező új beállításait használja.
```
<PropertyGroup>
  <ApplicationDefaultFont>Microsoft Sans Serif, 8.25pt</ApplicationDefaultFont>
</PropertyGroup>
```

A Application.SetDefaultFont(Font)hívásával.

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());
    }
}

Kategória

Windows Forms

Érintett API-k

Egyik sem.

A FolderBrowserDialog modernizálása

A FolderBrowserDialog vezérlő megváltozott a .NET Core-hoz készült Windows Forms-alkalmazásokban.

Leírás módosítása

A .NET-keretrendszerben a Windows-űrlapok a következő párbeszédpanelt használják a FolderBrowserDialog vezérlőelemhez:

A .NET-keretrendszerben található FolderBrowserDialogControl

A .NET Core 3.0-ban a Windows Forms egy újabb COM-alapú vezérlőt használ, amely a Windows Vista rendszerben lett bevezetve:

A FolderBrowserDialogControl a .NET Core

Bevezetett verzió

3.0

Javasolt művelet

A párbeszédpanel automatikusan frissül.

Ha meg szeretné őrizni az eredeti párbeszédpanelt, állítsa a FolderBrowserDialog.AutoUpgradeEnabled tulajdonságot false a párbeszédpanel megjelenítése előtt, ahogyan az a következő kódtöredékben látható:

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

Kategória

Windows Forms

Érintett API-k

FolderBrowserDialog

A SerializableAttribute el lett távolítva bizonyos Windows-űrlaptípusokból

A SerializableAttribute el lett távolítva néhány olyan Windows Forms-osztályból, amelyek nem rendelkeznek ismert bináris szerializálási forgatókönyvekkel.

Leírás módosítása

Az alábbi típusokat a .NET-keretrendszer SerializableAttribute díszíti, de az attribútum el lett távolítva a .NET Core-ban:

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

A szerializálási mechanizmusnak korábban komoly karbantartási és biztonsági problémái voltak. A SerializableAttribute típusokon való fenntartása azt jelenti, hogy ezeket a típusokat tesztelni kell a verzióról verzióra történő szerializálási változásokra és a keretrendszerek között végzett szerializálási változásokra. Ez megnehezíti ezeknek a típusoknak a fejlesztését, és költséges lehet fenntartani. Ezek a típusok nem rendelkeznek ismert bináris szerializálási forgatókönyvekkel, ami minimálisra csökkenti az attribútum eltávolításának hatását.

További információkért tekintse meg a Bináris szerializáció.

Bevezetett verzió

3.0

Javasolt művelet

Frissítse azokat a kódot, amelyek attól függhetnek, hogy ezek a típusok szerializálhatóként vannak megjelölve.

Kategória

Windows Forms

Érintett API-k

Egyik sem

Az AllowUpdateChildControlIndexForTabControls kompatibilitási kapcsoló nem támogatott

A Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls kompatibilitási kapcsolót a Windows Forms támogatja a .NET-keretrendszer 4.6-os és újabb verzióiban, de a .NET Core vagy a .NET 5.0 és újabb verziókban nem támogatott.

Leírás módosítása

A .NET-keretrendszer 4.6-os és újabb verzióiban a fül kiválasztása átrendezi a vezérlőgyűjteményt. A Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls kompatibilitási kapcsoló lehetővé teszi, hogy az alkalmazás kihagyja ezt az átrendezést, ha ez a viselkedés nem kívánatos.

A .NET Core és a .NET 5.0 és újabb verziókban a Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls kapcsoló nem támogatott.

Bevezetett verzió

3.0

Javasolt művelet

Távolítsa el a kapcsolót. A kapcsoló nem támogatott, és nem érhető el alternatív funkció.

Kategória

Windows Forms

Érintett API-k

Egyik sem

A DomainUpDown.UseLegacyScrolling kompatibilitási kapcsoló nem támogatott

A .NET-keretrendszer 4.7.1-ben bevezetett Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling kompatibilitási kapcsoló nem támogatott a .NET Core-on vagy a .NET 5.0-s és újabb verzióin futó Windows Formsban.

Leírás módosítása

A .NET-keretrendszer 4.7.1-től kezdve a Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling kompatibilitási kapcsoló lehetővé tette, hogy a fejlesztők kikapcsolják a független DomainUpDown.DownButton() és DomainUpDown.UpButton() műveleteket. A kapcsoló visszaállította az örökölt viselkedést, amelyben a DomainUpDown.UpButton() figyelmen kívül hagyja, ha a környezet szövege jelen van, és a fejlesztőnek DomainUpDown.DownButton() műveletet kell használnia a vezérlőn a DomainUpDown.UpButton() művelet előtt. További információért lásd a <AppContextSwitchOverrides> elemet.

A .NET Core és a .NET 5.0 és újabb verziókban a Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling kapcsoló nem támogatott.

Bevezetett verzió

3.0

Javasolt művelet

Távolítsa el a kapcsolót. A kapcsoló nem támogatott, és nem érhető el alternatív funkció.

Kategória

Windows Forms

Egyik sem

A Névjegy és a SplashScreen-sablonok hibásak

A Visual Studio által létrehozott About.vb és SplashScreen.vb fájlok olyan típusokra hivatkoznak a My névtérben, amelyek nem érhetők el .NET Core 3.0 és 3.1.

Bevezetett verzió

3.0

Leírás módosítása

A .NET Core 3.0 és 3.1 nem tartalmaz teljes Visual Basic My támogatást. A Visual Studio for Visual Basic Windows Forms-alkalmazások és SplashScreen űrlapsablonjairól szóló nem elérhető típusú referenciák.

Javasolt művelet

A Visual Basic My támogatása a .NET 5-ben javult, a projekt frissítése .NET 5 vagy újabb verzióra.

-vagy-

Javítsa ki az alkalmazás About és SplashScreen típusainak fordítóhibáit. A My.Application.Info típus által megadott információk lekéréséhez használja a System.Reflection.Assembly osztályt. Itt mindkét formátum közvetlen portja érhető el.

Borravaló

Ez egy mintakód, és nem optimális. Az attribútumok listáját gyorsítótárazni kell az űrlap feltöltési idejének csökkentése érdekében.

A ismertetése

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

Kategória

Visual Basic Windows Forms

Érintett API-k

Egyik sem

Lásd még:

Windows Forms-alkalmazás áttelepítése a .NET Core-ra

Megosztás a következőn keresztül:

A Windows Forms for .NET Core 3.0 és 3.1 kompatibilitástörő változásai

.NET Core 3.1

Eltávolított vezérlők

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A CellFormatting esemény nem kerül meghívásra, ha megjelenik az eszköztipp.

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

.NET Core 3.0

Alapértelmezett vezérlőelem betűtípusa Segoe UI 9 pt-ra módosult

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A FolderBrowserDialog modernizálása

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A SerializableAttribute el lett távolítva bizonyos Windows-űrlaptípusokból

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

Az AllowUpdateChildControlIndexForTabControls kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A DomainUpDown.UseLegacyScrolling kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A DoNotLoadLatestRichEditControl kompatibilitási kapcsolója nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

DoNotSupportSelectAllShortcutInMultilineTextBox kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A DontSupportReentrantFilterMessage kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

Az EnableVisualStyleValidation kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A UseLegacyContextMenuStripSourceControlValue kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet

Kategória

Érintett API-k

A UseLegacyImages kompatibilitási kapcsoló nem támogatott

Leírás módosítása

Bevezetett verzió

Javasolt művelet