.NET Core 3.0 ve 3.1 için Windows Forms'ta hataya neden olan değişiklikler

Makale
10/04/2023

Windows Forms desteği sürüm 3.0'da .NET Core'a eklendi. Bu makalede, Windows Forms'un tanıtıldığı .NET sürümüne göre hataya neden olan değişiklikler listelenir. Windows Forms uygulamasını .NET Framework'ten veya .NET Core'un önceki bir sürümünden (3.0 veya üzeri) yükseltiyorsanız, bu makale sizin için geçerlidir.

Bu sayfada aşağıdaki hataya neden olan değişiklikler belgelenmiştir:

Hataya neden olan değişiklik	Sürüm kullanıma sunulmuştur
Denetimler kaldırıldı	3.1
Araç ipucu gösteriliyorsa CellFormatting olayı tetiklenmiyor	3.1
Control.DefaultFont, Segoe UI 9 pt olarak değiştirildi	3.0
FolderBrowserDialog'un modernizasyonu	3.0
SerializableAttribute bazı Windows Forms türlerinden kaldırıldı	3.0
AllowUpdateChildControlIndexForTabControls uyumluluk anahtarı desteklenmiyor	3.0
DomainUpDown.UseLegacyScrolling uyumluluk anahtarı desteklenmiyor	3.0
DoNotLoadLatestRichEditControl uyumluluk anahtarı desteklenmiyor	3.0
DoNotSupportSelectAllShortcutInMultilineTextBox uyumluluk anahtarı desteklenmiyor	3.0
DontSupportReentrantFilterMessage uyumluluk anahtarı desteklenmiyor	3.0
EnableVisualStyleValidation uyumluluk anahtarı desteklenmiyor	3.0
UseLegacyContextMenuStripSourceControlValue uyumluluk anahtarı desteklenmiyor	3.0
UseLegacyImages uyumluluk anahtarı desteklenmiyor	3.0
Visual Basic için Hakkında ve SplashScreen şablonları bozuk	3.0

.NET Core 3.1

Denetimler kaldırıldı

.NET Core 3.1'den başlayarak, bazı Windows Forms denetimleri artık kullanılamaz.

Açıklama değiştirildi

.NET Core 3.1'den başlayarak, çeşitli Windows Forms denetimleri artık kullanılamaz. .NET Framework 2.0'da daha iyi tasarıma ve desteğe sahip değiştirme denetimleri kullanıma sunulmuştur. Kullanım dışı bırakılan denetimler daha önce tasarımcı araç kutularından kaldırılmıştı ancak hala kullanılabilir durumdaydı.

Aşağıdaki türler artık kullanılamaz:

Sürüm kullanıma sunulmuştur

3.1

Önerilen eylem

Kaldırılan her denetimin önerilen bir değiştirme denetimi vardır. Aşağıdaki tabloya bakın:

Denetim kaldırıldı (API)	Önerilen değiştirme	Kaldırılan ilişkili API'ler
ContextMenu	ContextMenuStrip
DataGrid	Datagridview	DataGridCell, DataGridRow, DataGridTableCollection, DataGridColumnCollection, DataGridTableStyle, DataGridColumnStyle, DataGridLineStyle, DataGridParentRowsLabel, DataGridParentRowsLabelStyle, DataGridBoolColumn, DataGridTextBox, GridColumnStylesCollection, GridTableStylesCollection, HitTestType
Mainmenu	MenuStrip
Menü	ToolStripDropDown, ToolStripDropDownMenu	Menuıtemcollection
MenuItem	Toolstripmenuıtem
ToolBar	ToolStrip	ToolBarAppearance
Toolbarbutton	Toolstripbutton	ToolBarButtonClickEventArgs, ToolBarButtonClickEventHandler, ToolBarButtonStyle, ToolBarTextAlign

Kategori

Windows Forms

Etkilenen API’ler

DataGridView Artık bir farenin üzerine gelindiğinde ve klavye aracılığıyla seçildiğinde hücrenin metin ve hata araç ipuçlarını gösterir. Bir araç ipucu gösteriliyorsa, DataGridView.CellFormatting olay tetiklenmez.

Açıklama değiştirildi

.NET Core 3.1'in ShowCellToolTips öncesinde, DataGridView özelliği true bir hücrenin metni için bir araç ipucu ve fareyle üzerine gelindiğinde oluşan hatalar için araç ipucu gösterilmişti. Klavye aracılığıyla bir hücre seçildiğinde araç ipuçları gösterilmedi (örneğin, Sekme tuşu, kısayol tuşları veya ok gezintisi kullanılarak). Kullanıcı bir hücreyi düzenlemişse ve daha sonra düzenleme modundayken DataGridView , özelliği ayarlanmamış bir hücrenin ToolTipText üzerine gelindiğinde, hücrenin metnini hücrede görüntülenecek şekilde biçimlendirmek için bir CellFormatting olay tetiklendi.

.NET Core 3.1'den başlayarak, .trueNET Core 3.1'den başlayarak, ShowCellToolTips DataGridView bir hücrenin metni için araç ipuçlarını ve yalnızca hücre vurgulandığında değil, aynı zamanda klavye aracılığıyla seçildiğinde hataları gösteren bir erişilebilirlik standartlarını karşılamak için. Bu değişikliğin bir sonucu olarak, CellFormatting özelliği ayarlanmamış ToolTipText hücreler düzenleme modundayken DataGridView üzerine gelindiğinde olay tetiklenmez. Vurgulanan hücrenin içeriği hücrede görüntülenmek yerine araç ipucu olarak gösterildiğinden olay tetiklenmez.

Sürüm kullanıma sunulmuştur

3.1

Önerilen eylem

Düzenleme modundayken DataGridView olaya bağlı CellFormatting olan tüm kodları yeniden düzenleyin.

Kategori

Windows Forms

Etkilenen API’ler

Hiçbiri

.NET Core 3.0

Varsayılan denetim yazı tipi Segoe UI 9 pt olarak değiştirildi

Açıklama değiştirildi

.NET Framework'te Control.DefaultFont özelliği olarak Microsoft Sans Serif 8.25 ptayarlanmıştır. Aşağıdaki resimde, varsayılan yazı tipini kullanan bir pencere gösterilmektedir.

.NET Framework'te varsayılan denetim yazı tipi

.NET Core 3.0'dan başlayarak varsayılan yazı tipi olarak ayarlanır Segoe UI 9 pt (ile aynı yazı tipi SystemFonts.MessageBoxFont). Bu değişikliğin sonucu olarak formlar ve denetimler, yeni varsayılan yazı tipinin daha büyük boyutunu hesaba katmak için yaklaşık %27 daha büyük boyutlandırılır. Örneğin:

.NET Core'da varsayılan denetim yazı tipi

Bu değişiklik, Windows kullanıcı deneyimi (UX) yönergeleriyle uyumlu olacak şekilde yapılmıştır.

Sürüm kullanıma sunulmuştur

3.0

Önerilen eylem

Formların ve denetimlerin boyutundaki değişiklik nedeniyle uygulamanızın doğru şekilde işlendiğini doğrulayın.

Tek bir formda özgün yazı tipini korumak için varsayılan yazı tipini olarak Microsoft Sans Serif 8.25 ptayarlayın. Örneğin:

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

Alternatif olarak, uygulamanın tamamı için varsayılan yazı tipini aşağıdaki yollardan biriyle değiştirebilirsiniz:

MSBuild özelliğini "Microsoft Sans Serif, 8.25pt" olarak ayarlayarak ApplicationDefaultFont . Visual Studio'ya tasarımcıdaki yeni ayarları kullanma izni verdiğinden bu tercih edilen tekniktir.
```
<PropertyGroup>
  <ApplicationDefaultFont>Microsoft Sans Serif, 8.25pt</ApplicationDefaultFont>
</PropertyGroup>
```

çağrısı Application.SetDefaultFont(Font)yaparak.

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

Kategori

Windows Forms

Etkilenen API’ler

Yok.

FolderBrowserDialog'un modernizasyonu

FolderBrowserDialog.NET Core için Windows Forms uygulamalarında denetim değişti.

Açıklama değiştirildi

.NET Framework'te, Windows forms denetim için FolderBrowserDialog aşağıdaki iletişim kutusunu kullanır:

.NET Framework'teki FolderBrowserDialogControl

.NET Core 3.0'da Windows Forms, Windows Vista'da kullanıma sunulan daha yeni bir COM tabanlı denetim kullanır:

.NET Core'daki FolderBrowserDialogControl

Sürüm kullanıma sunulmuştur

3.0

Önerilen eylem

İletişim kutusu otomatik olarak yükseltilir.

Özgün iletişim kutusunu korumak istiyorsanız, aşağıdaki kod parçasında FolderBrowserDialog.AutoUpgradeEnabled gösterildiği gibi, iletişim kutusunu göstermeden önce özelliğini false olarak ayarlayın:

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

Kategori

Windows Forms

Etkilenen API’ler

FolderBrowserDialog

SerializableAttribute bazı Windows Forms türlerinden kaldırıldı

, SerializableAttribute bilinen ikili serileştirme senaryoları olmayan bazı Windows Forms sınıflarından kaldırılmıştır.

Açıklama değiştirildi

Aşağıdaki türler .NET Framework'te ile SerializableAttribute dekore edilmiştir, ancak özniteliği .NET Core'da kaldırılmıştır:

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

Geçmişte bu serileştirme mekanizmasının ciddi bakım ve güvenlik kaygıları vardı. Türlerde bakım yapmak SerializableAttribute , bu türlerin sürümden sürüme serileştirme değişiklikleri ve çerçeveden çerçeveye serileştirme değişiklikleri için test edilmesi gerektiği anlamına gelir. Bu, bu türleri geliştirmeyi zorlaştırır ve bakımını yapmak maliyetli olabilir. Bu türlerde bilinen ikili serileştirme senaryoları yoktur ve bu da özniteliği kaldırmanın etkisini en aza indirir.

Daha fazla bilgi için bkz . İkili serileştirme.

Sürüm kullanıma sunulmuştur

3.0

Önerilen eylem

Bu türlerin serileştirilebilir olarak işaretlenmesine bağlı olabilecek tüm kodları güncelleştirin.

Kategori

Windows Forms

Etkilenen API’ler

Hiçbiri

AllowUpdateChildControlIndexForTabControls uyumluluk anahtarı desteklenmiyor

Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls Uyumluluk anahtarı.NET Framework 4.6 ve sonraki sürümlerde Windows Forms'da desteklenir, ancak .NET Core veya .NET 5.0 ve sonraki sürümlerde desteklenmez.

Açıklama değiştirildi

.NET Framework 4.6 ve sonraki sürümlerinde bir sekme seçildiğinde denetim koleksiyonu yeniden sıralanır. Uyumluluk anahtarı, Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls bir uygulamanın bu davranış istenmeyen durumlarda bu yeniden sıralamayı atlamasına olanak tanır.

.NET Core ve .NET 5.0 ve sonraki sürümlerinde Switch.System.Windows.Forms.AllowUpdateChildControlIndexForTabControls anahtar desteklenmez.

Sürüm kullanıma sunulmuştur

3.0

Önerilen eylem

Anahtarı kaldırın. Anahtar desteklenmez ve alternatif işlevler kullanılamaz.

Kategori

Windows Forms

Etkilenen API’ler

Hiçbiri

DomainUpDown.UseLegacyScrolling uyumluluk anahtarı desteklenmiyor

Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling.NET Framework 4.7.1'de kullanıma sunulan uyumluluk anahtarı, .NET Core veya .NET 5.0 ve sonraki sürümlerde Windows Forms'da desteklenmez.

Açıklama değiştirildi

.NET Framework 4.7.1'den başlayarak, uyumluluk anahtarı geliştiricilerin Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling bağımsız DomainUpDown.DownButton() ve DomainUpDown.UpButton() eylemlerden vazgeçmesine izin verdi. Anahtar, DomainUpDown.UpButton() bağlam metni mevcutsa öğesinin yoksayıldığı ve geliştiricinin eylemden önce DomainUpDown.UpButton() denetimde eylem kullanması DomainUpDown.DownButton() gereken eski davranışı geri yükledi. Daha fazla bilgi için bkz <. AppContextSwitchOverrides> öğesi.

.NET Core ve .NET 5.0 ve sonraki sürümlerinde Switch.System.Windows.Forms.DomainUpDown.UseLegacyScrolling anahtar desteklenmez.

Sürüm kullanıma sunulmuştur

3.0

Önerilen eylem

Anahtarı kaldırın. Anahtar desteklenmez ve alternatif işlevler kullanılamaz.

Kategori

Windows Forms

Hiçbiri

Hakkında ve SplashScreen şablonları bozuk

About.vb Visual Studio tarafından oluşturulan ve SplashScreen.vb dosyaları, ad alanında My .NET Core 3.0 ve 3.1 bulunmayan türlere başvurular içerir.

Sürüm kullanıma sunulmuştur

3.0

Açıklama değiştirildi

.NET Core 3.0 ve 3.1 tam Visual Basic My desteği içermez. Visual Basic Windows Forms uygulamaları için Visual Studio'daki Hakkında ve SplashScreen form şablonları, kullanılamayan türdeki özelliklere My.Application.Info başvurur.

Önerilen eylem

Visual Basic My desteği .NET 5'te geliştirildi, projenizi .NET 5 veya sonraki bir sürüme yükseltin.

-veya-

Uygulamanızdaki Hakkında ve SplashScreen türlerindeki derleyici hatalarını düzeltin. System.Reflection.Assembly türü tarafından sağlanan bilgileri almak için sınıfını My.Application.Info kullanın. Her iki formun da düz bağlantı noktası burada mevcuttur.

İpucu

Bu örnek koddur ve iyileştirilmemiştir. Form yükleme süresini azaltmak için öznitelik listesi önbelleğe alınmalıdır.

Hakkında

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

Kategori

Visual Basic Windows Forms

Etkilenen API’ler

Hiçbiri

Ayrıca bkz.

Windows Forms uygulamasını .NET Core'a taşıma

Aracılığıyla paylaş

.NET Core 3.0 ve 3.1 için Windows Forms'ta hataya neden olan değişiklikler

.NET Core 3.1

Denetimler kaldırıldı

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

Araç ipucu gösteriliyorsa CellFormatting olayı tetiklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

.NET Core 3.0

Varsayılan denetim yazı tipi Segoe UI 9 pt olarak değiştirildi

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

FolderBrowserDialog'un modernizasyonu

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

SerializableAttribute bazı Windows Forms türlerinden kaldırıldı

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

AllowUpdateChildControlIndexForTabControls uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

DomainUpDown.UseLegacyScrolling uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

DoNotLoadLatestRichEditControl uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

DoNotSupportSelectAllShortcutInMultilineTextBox uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

DontSupportReentrantFilterMessage uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

EnableVisualStyleValidation uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

UseLegacyContextMenuStripSourceControlValue uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem

Kategori

Etkilenen API’ler

UseLegacyImages uyumluluk anahtarı desteklenmiyor

Açıklama değiştirildi

Sürüm kullanıma sunulmuştur

Önerilen eylem