CA1727: Adlandırılmış yer tutucular için PascalCase kullanma

Özellik	Değer
Kural Kimliği	CA1727
Başlık	Adlandırılmış yer tutucular için PascalCase kullanma
Kategori	Adlandırma
Düzeltme bozucu ya da bozmayan olabilir	Kesintisiz
.NET 10'da varsayılan olarak etkin	Hayır
Geçerli diller	C# ve Visual Basic

Neden

ILogger ile kullanılan adlandırılmış bir yer tutucu PascalCase değildir.

Kural açıklaması

ile ILogger kullanılan adlandırılmış yer tutucu, bir addaki her bileşik sözcüğün ilk harfinin büyük harfle yazıldığı bir adlandırma kuralı olan PascalCase olmalıdır. Bu adlandırma kuralı, yapılandırılmış günlük kaydında her adlandırılmış yer tutucunun yapılandırılmış verilerde özellik adı olarak kullanıldığı durumlar için önerilir.

İhlalleri düzeltme

Adlandırılmış yer tutucular için PascalCase kullanın. Örneğin, {firstName}'yi {FirstName} ile değiştirin.

Example

public class UserService
{
    private readonly ILogger<UserService> _logger;

    public UserService(ILogger<UserService> logger)
    {
        _logger = logger;
    }

    public void Create(string firstName, string lastName)
    {
        // This code violates the rule.
        _logger.LogInformation("Creating user {firstName} {lastName}", firstName, lastName);

        // This code satisfies the rule.
        _logger.LogInformation("Creating user {FirstName} {LastName}", firstName, lastName);
    }
}

Uyarıların ne zaman bastırılması gerekiyor?

Bu kuraldan gelen bir uyarıyı engellemek güvenlidir.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA1727
// The code that's violating the rule is on this line.
#pragma warning restore CA1727

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1727.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.