Aracılığıyla paylaş

Property Deyimi

  • Makale

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:

Bkz: Visual Basic'de Erişim Düzeyleri

propertymodifiers

İsteğe Bağlı.Aşağıdakilerden biri olabilir:

Shared

İsteğe Bağlı.Bkz: Shared (Visual Basic)

Shadows

İsteğe Bağlı.Bkz: Shadows (Visual Basic)

ReadOnly

İsteğe Bağlı.Bkz: ReadOnly (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ça

Description

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 Bağlamları 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

Get Deyimi

Set Deyimi (Visual Basic)

Parametre Listesi (Visual Basic)

Varsayılan (Visual Basic)

Kavramlar

Otomatik Uygulanan Özellikler (Visual Basic)

Diğer Kaynaklar

Visual Basic'de Nesneler ve Sınıflar