CA2243: Öznitelik dize harfleri doğru çözümlenmelidir

Özellik	Değer
Kural Kimliği	CA2243
Başlık	Öznitelik dize harfleri doğru çözümlenmelidir
Kategori	Kullanım
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

Bir özniteliğin dize değişmez değeri parametresi, URL, GUID veya Sürüm için doğru biçimde ayrıştırılamaz.

Kural açıklaması

Öznitelikler 'den System.Attributetüretildiğinden ve öznitelikler derleme zamanında kullanıldığından, oluşturucularına yalnızca sabit değerler geçirilebilir. URL'leri, GUID'leri ve Sürümleri temsil etmesi gereken öznitelik parametreleri, , System.Urive System.Guidolarak System.Versionyazılamaz, çünkü bu türler sabit olarak temsil edilemez. Bunun yerine, bunlar string'ler ile temsil edilmelidir.

Parametre bir dize olarak yazıldığı için, derleme zamanında yanlış biçimlendirilmiş bir parametre geçirilebilir.

Bu kural, bir Tekdüzen Kaynak Tanımlayıcı (URI), bir Genel Benzersiz Tanımlayıcı (GUID) veya bir Sürüm temsil eden parametreleri belirlemek için buluşsal adlandırma yöntemi kullanır ve gönderilen değerin doğruluğunu kontrol eder.

İhlalleri düzeltme

Parametre dizesini doğru biçimlendirilmiş bir URL, GUID veya Sürüm olarak değiştirin.

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

Parametre bir URL, GUID veya Sürüm temsil etmiyorsa, 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 CA2243
// The code that's violating the rule is on this line.
#pragma warning restore CA2243

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.CA2243.severity = none

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

Örnek

Aşağıdaki örnek, bu kuralı ihlal eden AssemblyFileVersionAttribute kodunu gösterir.

[AttributeUsage(AttributeTargets.Assembly, Inherited = false)]
[ComVisible(true)]
public sealed class AssemblyFileVersionAttribute : Attribute
{
    public AssemblyFileVersionAttribute(string version) { }

    public string? Version { get; set; }
}

// Since the parameter is typed as a string, it is possible
// to pass an invalid version number at compile time. The rule
// would be violated by the following code: [assembly : AssemblyFileVersion("xxxxx")]

Kural aşağıdaki parametrelerle tetikleniyor:

• 'version' içeren ve System.Version'a ayrıştırılamayan parametreler.

• 'guid' içeren ve System.Guid'ye ayrıştırılamayan parametreler.

• 'uri', 'urn' veya 'url' içeren ve System.Uri'ye ayrıştırılamayan parametreler.

Ayrıca bkz.

• CA1054: URI parametreleri dizeler olmamalıdır