3.0'a yükseltme

Bugün kullandığınız sürümün bölümünü seçin. Değişikliklerin çoğu derleyicinin gösterdiği ad değişiklikleridir.

2.x'ten

HeroKit 3.0, yalnızca Türkiye'ye özgü metotların (...Tr, ToTurkish...) yerine Country, Language ya da Currency alan tek bir metot kümesi getirir. Türkiye Countries.Turkey, Languages.Turkish ve Currencies.TurkishLira olarak hazır gelir. Diğer ülkeler eklendikleri anda aynı metotları kullanır: bkz. Ülkeler ve diller.

Davranış ve sonuçlar aynıdır.

Namespace'ler

2.x	3.0
`using HeroKit.Turkish;`	`using HeroKit.Globalization;`
`IsValidTckn`, `IsValidVkn`	`using HeroKit.Globalization.Turkey;`

Telefon numaraları

2.x	3.0
`value.IsValidPhoneTr()`	`value.IsValidPhone(Countries.Turkey)`
`value.IsValidMobileTr()`	`value.IsValidMobilePhone(Countries.Turkey)`
`value.ToE164Tr()`	`value.ToE164(Countries.Turkey)`
`value.FormatPhoneTr()`	`value.FormatPhone(Countries.Turkey)`

Kimlik, vergi, plaka, posta kodu ve bölgeler

2.x	3.0
`value.IsValidTckn()`, `value.IsValidVkn()`	değişmedi (namespace `HeroKit.Globalization.Turkey`)
—	`value.IsValidNationalId(Countries.Turkey)` (TCKN)
`value.IsValidTaxIdTr()`	`value.IsValidTaxId(Countries.Turkey)`
`value.IsValidPlateTr()`	`value.IsValidVehiclePlate(Countries.Turkey)`
`value.FormatPlateTr()`	`value.FormatVehiclePlate(Countries.Turkey)`
`value.IsValidPostalCodeTr()`	`value.IsValidPostalCode(Countries.Turkey)`
`"34".ToProvinceName()`	`Countries.Turkey.FindRegion("34")?.Name`
`6.ToProvinceName()`	`Countries.Turkey.FindRegion(6)?.Name`
`"sanliurfa".ToProvinceCode()`	`Countries.Turkey.FindRegion("sanliurfa")?.Code`
`TurkishProvinces.All`	`Countries.Turkey.Regions` (`Region(Code, Name)` listesi)

FindRegion bilinmeyen bir bölge için null döner.

Tutar, para birimi ve yazıyla sayı

2.x	3.0
`123.ToTurkishWords()`	`123.ToWords(Languages.Turkish)`
`amount.ToTurkishCurrencyWords()`	`amount.ToCurrencyWords(Currencies.TurkishLira)`
`amount.ToTurkishCurrencyWords("Euro", "sent")`	`amount.ToCurrencyWords(new Currency("EUR", "€", Languages.Turkish) { UnitName = "Euro", SubunitName = "sent" })`
`amount.ToTurkishLira()`	`amount.ToCurrencyString(Currencies.TurkishLira)`
`amount.ToTurkishLira(TurkishLiraFormat.Code)`	`amount.ToCurrencyString(Currencies.TurkishLira, CurrencyStyle.Abbreviation)` (`"1.234,50 TL"`)
—	`CurrencyStyle.IsoCode` (`"1.234,50 TRY"`)

Resmî tatiller ve iş günleri

2.x	3.0
`TurkishHolidays.GetHolidays(2026)`	`Countries.Turkey.Holidays!.GetHolidays(2026)`
`date.IsPublicHolidayTr()`	`date.IsPublicHoliday(Countries.Turkey)`
`date.IsHalfDayHolidayTr()`	`date.IsHalfDayHoliday(Countries.Turkey)`
`date.GetPublicHolidayTr()`	`date.GetPublicHoliday(Countries.Turkey)`
`date.IsBusinessDayTr()`	`date.IsBusinessDay(Countries.Turkey)`
`date.AddBusinessDaysTr(n)`	`date.AddBusinessDays(n, Countries.Turkey)`
`date.BusinessDaysUntilTr(end)`	`date.CountBusinessDays(end, Countries.Turkey)` (3.7.0+, yarım gün 0,5 sayılır)

Harf büyüklüğü ve metin

2.x	3.0
`value.ToTitleCaseTr()`	`value.ToTitleCase(Languages.Turkish)`
`value.EqualsTr(other)`	`value.EqualsIgnoreCase(other, Languages.Turkish)`
`value.RemoveAccent()`	`value.RemoveDiacritics()`
`value.ClearTurkishChars()`	`value.RemoveDiacritics()`

RemoveDiacritics sabit bir karakter tablosu kullanır; bu yüzden her sistemde aynı sonucu verir. Latin-1 ve yaygın Orta Avrupa harflerini de kapsar.

Doğrulama öznitelikleri

2.x	3.0
`[TurkishPhone]`, `[TurkishPhone(MobileOnly = true)]`	`[PhoneNumber("TR")]`, `[PhoneNumber("TR", MobileOnly = true)]`
`[PlateTr]`	`[VehiclePlate("TR")]`
`[PostalCodeTr]`	`[PostalCode("TR")]`
`[TaxIdTr]`	`[TaxId("TR")]`
—	`[NationalId("TR")]`
`[Tckn]`, `[Vkn]`, `[Iban]`, `[CardNumber]`	değişmedi

FluentValidation

2.x	3.0
`TurkishPhone(mobileOnly)`	`PhoneNumber(Countries.Turkey, mobileOnly)`
`PlateTr()`	`VehiclePlate(Countries.Turkey)`
`PostalCodeTr()`	`PostalCode(Countries.Turkey)`
`TaxIdTr()`	`TaxId(Countries.Turkey)`
—	`NationalId(Countries.Turkey)`
`Tckn()`, `Vkn()`, `Iban()`, `CardNumber()`	değişmedi

3.0'da yeni

Bunlar daha önce yayımlanmış bir sürümde yoktu:

e-Fatura ve e-Arşiv: GibInvoiceNumber (TryParse, Create, Next), IsValidGibInvoiceNumber, IsValidEttn, [GibInvoiceNumber] ve [Ettn] öznitelikleri, GibInvoiceNumber() ve Ettn() FluentValidation kuralları.
ICU olmadan Türkçe sıralama: Languages.Turkish.TextRules!.Comparer ve IgnoreCaseComparer; Array.Sort, OrderBy(key, comparer) ile ya da sözlük karşılaştırıcısı olarak kullanılır. Değişmez globalleştirmeyle de çalışır.
Harf büyüklüğü: ToUpper(Languages.Turkish) ve ToLower(Languages.Turkish).
Kendi ülkeniz, diliniz ya da para biriminiz: new Country(...), Countries.Register, new Language(...), new Currency(...).

Güncelleme listesi

using HeroKit.Turkish; satırını using HeroKit.Globalization; ile değiştirin; IsValidTckn ya da IsValidVkn çağırdığınız yere using HeroKit.Globalization.Turkey; ekleyin.
Çağrıları yukarıdaki tablolara göre yeniden adlandırın. Derleyici eski adların hepsini listeler.
Ülke özniteliklerini ve FluentValidation kurallarını değiştirin.

1.x'ten

Önce bu değişiklikleri uygulayın, sonra 2.x'ten tablolarını.

HeroKit 2.0 her dönüşüme tek bir hata politikası uygular, adları tutarlı hâle getirir ve eski ya da .NET'in kendisiyle çakışan yardımcıları kaldırır. Değişikliklerin çoğu, derleyicinin gösterdiği yeniden adlandırmalardır.

Dönüşümler

Toleranslı ToX varsayılan değer döner; TryToX false döner. İkisi de hatalı girdide istisna fırlatmaz.

1.x	2.0
`"x".ToDecimal(",", true)` (geçersiz girdide istisna fırlatırdı)	`"x".ToDecimal()` 0 döner; `ToDecimal(defaultValue, provider)`; `TryToDecimal(out …)`
`"x".ToDateTime(culture, defaultValue)`	`"x".ToDateTime(defaultValue, provider)`
`"x".ToBoolean(trueCondition: "yes", defaultvalue: false)`	`"x".ToBoolean(trueText: "yes", defaultValue: false)`
`"x".ToEnum<T>()` her `T` için	`T : struct, Enum`; yeni `TryToEnum<T>(out …)`
`"x".ToNullable<T>()` → `(bool status, T? result)`	`"x".ToNullable<T>()` → `T?` (başarısızlıkta null)
`"x".ToByteArray()` (geçersiz base64'te istisna fırlatırdı)	`"x".FromBase64()` → `byte[]?`
`obj.ConvertTo<T>()` (geçersiz girdide istisna fırlatırdı)	varsayılan değeri döner; `TryConvertTo<T>(out …)`
`obj.TryCast<T>(out …)`	`obj.TryConvertTo<T>(out …)`
`property.TrySetConvertedValue<T>(instance, value)`	`property.TrySetConvertedValue(instance, value)`
—	Her `IParsable<T>` için `"x".To<T>()` / `TryTo<T>(out …)`

TryConvertTo ve TrySetConvertedValue artık null girdide, onu varsayılan değere çevirmek yerine false döner. TrySetConvertedValue(instance, null) referans tipli ve null olabilen özellikleri temizler.

Yeniden adlandırmalar

1.x	2.0
`IsEvenNumber()` / `IsOddNumber()`	`IsEven()` / `IsOdd()`
`ToMonthString(cultureInfo)`	`ToMonthName(culture)`
`flag.ToString("Yes", "No")`	`flag.ToText("Yes", "No")`
`status.GetValue<int>()` → `"2"`	`status.ToUnderlying<int>()` → `2`
`array.InsertItems(items)`	`array.CopyFrom(items)` (sayıyı döner)
`bytes.UrlTokenEncode()`	`bytes.ToBase64Url()` (RFC 4648 URL güvenli base64)
`date.ToCultureString(formatProvider: …)`	`date.ToCultureString(culture: …)`

Tek değerli parametreler her yerde value olarak adlandırılır (önceden input, datetime, target, number, source). Adlandırılmış argüman kullandıysanız güncelleyin.

Kaldırılanlar

Kaldırılan	Yerine kullanın
`ToUpperTr()`, `ToLowerTr()`	`ToUpper(Languages.Turkish)`, `ToLower(Languages.Turkish)`
`ToTrString()`	`ToCultureString(CultureInfo.GetCultureInfo("tr-TR"))`
`PropertyInfoExtensions.SetValue<T>()`	`TrySetConvertedValue(instance, value)`
`ToPixel()`	`point * 4m / 3m`
`Seconds()`	`TimeSpan.FromSeconds(n)`
`NameEqualityComparer`	`StringComparer.OrdinalIgnoreCase`
`array.ToList(mapFunction)`	`array.Select(map).ToList()`
`TypesExtensions.GetDefault<T>()`	`default(T)`

Table of Contents