Özellik deyimi
Bir özellik ve depolamak ve özelliğinin değerini almak için kullanılan özellik yordamlarını adını bildirir.
[ <attributelist> ] [ Default ] [ accessmodifier ]
[ propertymodifiers ] [ Shared ] [ Shadows ] [ ReadOnly | WriteOnly ] [ Iterator ]
Property name ( [ parameterlist ] ) [ As returntype ] [ Implements implementslist ]
[ <attributelist> ] [ accessmodifier ] Get
[ statements ]
End Get
[ <attributelist> ] [ accessmodifier ] Set ( ByVal value As returntype [, parameterlist ] )
[ statements ]
End Set
End Property
- or -
[ <attributelist> ] [ Default ] [ accessmodifier ]
[ propertymodifiers ] [ Shared ] [ Shadows ] [ ReadOnly | WriteOnly ]
Property name ( [ parameterlist ] ) [ As returntype ] [ Implements implementslist ]
Bölümleri
Terim |
Tanım |
attributelist |
İsteğe Bağlı.Bu özellik için geçerli öznitelikler listesi, ya da Get veya Set yordam.Bkz: öznitelik listesi. |
Default |
İsteğe Bağlı.Bu özellik, sınıf veya yapı tanımlanmış varsayılan özelliği olduğunu belirtir.Varsayılan Özellikler parametreleri kabul etmeniz gerekir ve ayarlanabilir ve özellik adı belirtmeden alınır.Özellik olarak bildirirseniz Default, kullanamazsınız Private özelliği veya kendi özellik yordamlardan birini. |
accessmodifier |
İsteğe bağlı Property ifadesi ve en fazla bir Get ve Set deyimleri.Aşağıdakilerden biri olabilir: |
propertymodifiers |
İsteğe Bağlı.Aşağıdakilerden biri olabilir:
|
Shared |
İsteğe Bağlı.Bkz: Paylaşılan (Visual Basic) |
Shadows |
İsteğe Bağlı.Bkz: Gölgeler (Visual Basic) |
ReadOnly |
İsteğe Bağlı.Bkz: Salt okunur (Visual Basic) |
WriteOnly |
İsteğe Bağlı.Bkz: WriteOnly (Visual Basic) |
Iterator |
İsteğe Bağlı.Bkz: Yineleyici. |
name |
Gerekli.Özelliğin adı.Bkz: Bildirilen öğe adları (Visual Basic) |
parameterlist |
İsteğe Bağlı.Yerel değişken listesi adlarını bu özellik parametreleri ve olası ek parametreleri temsil eden Set yordam.Bkz: Parametre listesi (Visual Basic) |
returntype |
Required if OptionStrict is On.Bu özelliği tarafından döndürülen değerin veri türü. |
Implements |
İsteğe Bağlı.Bu özellik, emin bir veya daha fazla özellik, bu özellik içeren sınıf veya yapı tarafından uygulanan bir arabirimi tanımlanan her birini uygulayan gösterir.Bkz: Implements deyimi |
implementslist |
Gerekli if Implements sağlanır.Uygulanan özelliklerin listesi. implementedproperty [ , implementedproperty ... ] Her implementedproperty aşağıdaki sözdizimi ve bölümleri vardır: interface.definedname
ParçaDescription
interface Gerekli.Sınıf veya yapı içeren bu özelliği tarafından uygulanan bir arabirimin adı.
definedname Gerekli.Hangi tarafından özellik tanımlanmış ad interface.
|
Get |
İsteğe Bağlı.Özellik işaretlenmiş olması gereken WriteOnly.Başlatan bir Get özelliğinin değeri döndürmek için kullanılan özellik yordam. |
statements |
İsteğe Bağlı.İçinde çalıştırmak için deyimleri bloğunu Get veya Set yordam. |
End Get |
Sona Get özellik yordam. |
Set |
İsteğe Bağlı.Özellik işaretlenmiş olması gereken ReadOnly.Başlatan bir Set özelliğinin değeri saklamak için kullanılan özellik yordam. |
End Set |
Sona Set özellik yordam. |
End Property |
Bu özelliğin tanımını sonlandırır. |
Notlar
Property Deyimi bildiriminde bir özelliğin tanıtır.Bir özelliğin sahip olabileceği bir Get yordam (salt okunur), bir Set yordamı (yalnızca yazma) veya her ikisi de (okuma-yazma).Atlayabilirsiniz Get ve Set otomatik olarak uygulanan bir özelliğini kullanırken yordam.Daha fazla bilgi için bkz. Otomatik uygulanan özellikler (Visual Basic).
Kullanabileceğiniz Property sınıf düzeyinde.Bunun anlamı bildiriminin içerik için bir özellik sınıf, yapı, modül veya arabirim olmalıdır ve kaynak dosya, ad alanı, yordam veya bloğu olamaz.Daha fazla bilgi için bkz. Bildirim içerikleri ve varsayılan erişim düzeyleri (Visual Basic).
Varsayılan olarak, ortak erişim özelliklerini kullanın.Bir özelliğin bir erişim değiştiricisi ile erişim düzeyini ayarlayabilirsiniz Property ifade ve isteğe bağlı olarak ayarlayabilir, daha kısıtlayıcı bir erişim düzeyi için özellik yordamlardan birini.
Visual Basic parametresi geçirir Set yordam özellik atamaları sırasında.Bir parametre için sağlamazsanız Set, tümleşik geliştirme ortamı (IDE) adlı bir örtülü parametresini kullanır value.Bu parametre özelliğine atanan değer bulunur.Genellikle bu değer özel bir yerel değişkende depolayın ve o zaman Get yordamı çağırılır.
Kurallar
Karma erişim düzeyleri. Okuma-yazma özelliği tanımlıyorsanız, isteğe bağlı olarak farklı erişim düzeyi için belirtebileceğiniz Get veya Set yordam, ancak her ikisini birden değil.Bunu yaparsanız, yordam erişim düzeyi özellik erişim düzeyinden daha fazla kısıtlayıcı olmalıdır.Örneğin, özellik olarak bildirilmiş Friend, size bildirmek Set yordam Private, ama Public.
Tanımlıyorsanız, bir ReadOnly veya WriteOnly özelliği, tek özellik yordamı (Get veya Set, sırasıyla) tüm özelliğini temsil eder.Özellik için iki erişim düzeyi ayarlamak için bu tür bir yordam için farklı erişim düzeyi bildirimini yapamazsınız.
**Dönüş türü.**Property İfade döndürdüğü değerin veri türü bildirmek.Numaralandırma, yapısı, sınıf veya arabirim adı veya herhangi bir veri türü belirtebilirsiniz.
Belirtmezseniz, returntype, özellik döndürür Object.
Uygulaması. Bu özellik kullanıyorsa, Implements anahtar sözcüğü, içeren sınıf veya yapı olması gerekir bir Implements hemen deyimi kendi Class veya Structure ifadesi.Implements Deyimi içinde belirtilen her arabirimi içermelidir implementslist.Ancak, olarak tanımlayan bir arabirim adı Property (içinde definedname) bu özelliğin adıyla aynı olması gerekmez (de name).
Davranış
Bir özellik yordam döndürülüyor. Zaman Get veya Set yordamı çağıran kodun verir, yürütme kendisini çağıran deyimi aşağıdaki deyimi ile devam eder.
Exit Property Ve Return ifadeleri neden hemen Çık özellik yordamdan.Herhangi bir sayıda Exit Property ve Return ifadeleri görüntülenebilir herhangi bir yordam ve karıştırmak Exit Property ve Return deyimleri.
Dönüş değeri. Bir değer almak için bir Get yordamı, değer atamak için özellik adı veya içinde olmasını bir Return ifadesi.Aşağıdaki örnek için özellik adı dönüş değeri atar quoteForTheDay ve daha sonra kullanır Exit Property return deyimi.
Private quoteValue As String = "No quote assigned yet."
ReadOnly Property quoteForTheDay() As String Get quoteForTheDay = quoteValue Exit Property End Get End Property
Kullanırsanız, Exit Property bir değer atama olmadan name, Get yordam özelliğin veri türü için varsayılan değer verir.
Return Aynı anda ifade atar Get yordamı dönüş değeri ve yordamı çıkar.Aşağıdaki örnekte bu gösterilmektedir.
Private quoteValue As String = "No quote assigned yet."
ReadOnly Property quoteForTheDay() As String Get Return quoteValue End Get End Property
Örnek
Aşağıdaki örnek bir sınıf içinde bir özellik bildirir.
Class Class1
' Define a local variable to store the property value.
Private propertyValue As String
' Define the property.
Public Property prop1() As String
Get
' The Get property procedure is called when the value
' of a property is retrieved.
Return propertyValue
End Get
Set(ByVal value As String)
' The Set property procedure is called when the value
' of a property is modified. The value to be assigned
' is passed in the argument to Set.
propertyValue = value
End Set
End Property
End Class
Ayrıca bkz.
Başvuru
Parametre listesi (Visual Basic)
Kavramlar
Otomatik uygulanan özellikler (Visual Basic)