Kısmi (Visual Basic)

  • Makale

Tür bildiriminin türün kısmi tanımı olduğunu gösterir.

Anahtar sözcüğünü kullanarak bir türün tanımını birkaç bildirime Partial bölebilirsiniz. İstediğiniz kadar farklı kaynak dosyada istediğiniz kadar kısmi bildirim kullanabilirsiniz. Ancak, tüm bildirimler aynı derlemede ve aynı ad alanında olmalıdır.

Not

Visual Basic genellikle kısmi sınıflarda uygulanan kısmi yöntemleri destekler. Daha fazla bilgi için bkz . Kısmi Yöntemler ve Alt Deyim.

Sözdizimi

[ <attrlist> ] [ accessmodifier ] [ Shadows ] [ MustInherit | NotInheritable ] _  
Partial { Class | Structure | Interface | Module } name [ (Of typelist) ]  
    [ Inherits classname ]  
    [ Implements interfacenames ]  
    [ variabledeclarations ]  
    [ proceduredeclarations ]  
{ End Class | End Structure }

Parça

Süre Tanım
attrlist isteğe bağlı. Bu türe uygulanan özniteliklerin listesi. Öznitelik Listesi'ni açılı ayraç (< > ) içine almanız gerekir.
accessmodifier isteğe bağlı. Bu türe hangi kodun erişebileceğini belirtir. Bkz. Visual Basic'te erişim düzeyleri.
Shadows isteğe bağlı. Bkz. Gölgeler.
MustInherit isteğe bağlı. Bkz . MustInherit.
NotInheritable isteğe bağlı. Bkz. NotInheritable.
name Gerekli. Bu türün adı. Aynı türdeki diğer tüm kısmi bildirimlerde tanımlanan adla eşleşmelidir.
Of isteğe bağlı. Bunun genel bir tür olduğunu belirtir. Bkz. Visual Basic'te Genel Türler.
typelist Of kullanıyorsanız gereklidir. Bkz. Tür Listesi.
Inherits isteğe bağlı. Bkz. Inherits Deyimi.
classname kullanıyorsanız Inheritsgereklidir. Bu sınıfın türetildiği sınıfın veya arabirimin adı.
Implements isteğe bağlı. Bkz . Implements Deyimi.
interfacenames kullanıyorsanız Implementsgereklidir. Bu türün uyguladığı arabirimlerin adları.
variabledeclarations isteğe bağlı. Türü için ek değişkenler ve olaylar bildiren deyimler.
proceduredeclarations isteğe bağlı. Türü için ek yordamlar bildiren ve tanımlayan deyimler.
End Class veya End Structure Bu kısmi Class veya Structure tanımı sonlandırır.

Açıklamalar

Visual Basic, oluşturulan kodu ayrı kaynak dosyalarda kullanıcı tarafından yazılan koddan ayırmak için kısmi sınıf tanımları kullanır. Örneğin, Windows Form Tasarım Aracı gibi Formdenetimler için kısmi sınıflar tanımlar. Bu denetimlerde oluşturulan kodu değiştirmemelisiniz.

Sınıf, yapı, arabirim ve modül oluşturma için değiştirici kullanım ve devralma gibi tüm kurallar kısmi bir tür oluştururken uygulanır.

En İyi Uygulamalar

  • Normal koşullarda, tek bir türün geliştirilmesini iki veya daha fazla bildirime bölmemelisiniz. Bu nedenle, çoğu durumda anahtar sözcüğüne Partial ihtiyacınız yoktur.

  • Okunabilirlik için, bir türün her kısmi bildirimi anahtar sözcüğünü Partial içermelidir. Derleyici en fazla bir kısmi bildirimin anahtar sözcüğünü atmasına izin verir; iki veya daha fazla atlarsa, derleyici bir hata sinyali gönderir.

Davranış

  • Bildirimler Birliği. Derleyici, türü tüm kısmi bildirimlerinin birleşimi olarak ele alır. Her kısmi tanımdaki her değiştirici türün tamamı için geçerlidir ve her kısmi tanımdaki her üye türün tamamı için kullanılabilir.

  • Modüllerdeki Kısmi Türler için Tür Yükseltmeye İzin Verilmiyor. Modülün içinde kısmi bir tanım varsa, bu türün tür yükseltmesi otomatik olarak yenilir. Böyle bir durumda, kısmi tanımlar kümesi beklenmeyen sonuçlara ve hatta derleyici hatalarına neden olabilir. Daha fazla bilgi için bkz . Tür Yükseltme.

    Derleyici, kısmi tanımları yalnızca tam yolları aynı olduğunda birleştirir.

anahtar Partial sözcüğü şu bağlamlarda kullanılabilir:

Class Deyimi

Structure Deyimi

Örnek

Aşağıdaki örnek, sınıfın sampleClass tanımını her biri farklı Sub bir yordam tanımlayan iki bildirime böler.

Partial Public Class sampleClass
    Public Sub sub1()
    End Sub
End Class
Partial Public Class sampleClass
    Public Sub sub2()
    End Sub
End Class

Önceki örnekteki iki kısmi tanım aynı kaynak dosyada veya iki farklı kaynak dosyada olabilir.

Ayrıca bkz.