Makale numarası: 110264 - Son Gözden Geçirme: 09 Ocak 2003 Perşembe - Gözden geçirme: 1.1 BILGI: Microsoft Consulting adlandırma kuralları Visual Basic for Hizmetleri
Bu SayfadaÖzetVisual Basic kodunuzun adlandırma kurallarına kurmak için iyi bir fikirdir. Bu makalede, Microsoft Consulting Services (MCS) tarafından kullanılan bir adlandırma kurallarına sağlar. Bu belgenin bir "Programmer's Guide" Visual Basic'te bulunan Visual Basic kodlama kuralları kümesidir. Not: Bu makalede belirtilen üçüncü taraf denetimlerin, Microsoft'tan bağımsız satıcılar tarafından üretilmektedir. Microsoft, örtük veya başka bir biçimde garanti, bu denetimlerin performansı veya güvenilirliği konusunda sağlar. Daha fazla bilgiAdlandırma kuralları, Visual Basic programcıları yardımcı olur:
Ortamı seçeneklerini ayarlamaOption explicit'nı kullanın. Yazım hatalarını (örneğin, aUserNameTmp karşılık. neden olan hataların sayısını azaltarak zaman programlama kaydetmek için tüm değişkenleri bildirmek sUserNameTmp sUserNameTemp karşılaştırması). Ortam Seçenekleri iletişim kutusunda, değişken tanımlaması iste Evet'e ayarlayın. Seçenek Belirtik deyimi, Visual Basic programında tüm değişkenleri bildirmek gerekir. Dosyaları ASCII metin olarak kaydedin. <a1>Form</a1> (.FRM) ve modülü tarafından disk bozulması nedeniyle zarar en aza sürüm denetimi sistemleri kullanımını kolaylaştırmak için ASCII metin olarak (.BAS) dosyalarını kaydedin. Buna ek olarak, şunları yapabilirsiniz:
Adlandırma kuralları standart nesneleri için nesneAşağıdaki tablolarda, MCS standart nesne ad önekleri belirtin. Bu önekleri Visual Basic programcıları Rehber'de belgelenen tutarlı.Prefix Object Type Example ------------------------------------------------------- ani Animation button aniMailBox bed Pen Bedit bedFirstName cbo Combo box and drop down list box cboEnglish chk Checkbox chkReadOnly clp Picture clip clpToolbar cmd (3d) Command button (3D) cmdOk (cmd3dOk) com Communications comFax ctr Control (when specific type unknown) ctrCurrent dat Data control datBiblio dir Directory list box dirSource dlg Common dialog control dlgFileOpen drv Drive list box drvTarget fil File list box filSource frm Form frmEntry fra (3d) Frame (3d) fraStyle (fra3dStyle) gau Gauge gauStatus gpb Group push button gpbChannel gra Graph graRevenue grd Grid grdPrices hed Pen Hedit hedSignature hsb Horizontal scroll bar hsbVolume img Image imgIcon ink Pen Ink inkMap key Keyboard key status keyCaps lbl Label lblHelpMessage lin Line linVertical lst List box lstPolicyCodes mdi MDI child form mdiNote mpm MAPI message mpmSentMessage mps MAPI session mpsSession mci MCI mciVideo mnu Menu mnuFileOpen opt (3d) Option Button (3d) optRed (opt3dRed) ole OLE control oleWorksheet out Outline control outOrgChart pic Picture picVGA pnl3d 3d Panel pnl3d rpt Report control rptQtr1Earnings shp Shape controls shpCircle spn Spin control spnPages txt Text Box txtLastName tmr Timer tmrAlarm vsb Vertical scroll bar vsbRate Veritabanı nesneleri için adlandırma kuralı nesnesiPrefix Object Type Example ------------------------------------------ db ODBC Database dbAccounts ds ODBC Dynaset object dsSalesByRegion fdc Field collection fdcCustomer fd Field object fdAddress ix Index object ixAge ixc Index collection ixcNewAge qd QueryDef object qdSalesByRegion qry (suffix) Query (see NOTE) SalesByRegionQry ss Snapshot object ssForecast tb Table object tbCustomer td TableDef object tdCustomers Menü adlandırma kurallarıUygulamalar, sık bir bollukla menü denetimleri kullanın. Sonuç olarak, bu denetimler için farklı bir adlandırma kurallarına gerekir. Menü denetimi önekleri, iç içe geçme, son menü başlık adı dizesinin sonunda her düzey için ek bir önek ekleyerek, ilk mnu etiket genişletilmesi. Örneğin:Menu Caption Sequence Menu Handler Name Help.Contents mnuHelpContents File.Open mnuFileOpen Format.Character mnuFormatCharacter File.Send.Fax mnuFileSendFax File.Send.Email mnuFileSendEmail Diğer denetimler için adlandırma kurallarıYeni denetimler için yukarıda listelenen benzersiz üç karakter önekiyle birlikte gelen deneyin. Ancak, üç karakterle yapıştırmak üzere daha temiz olmasını daha önemlidir.Türetilmiş denetimleri gibi bir Gelişmiş liste kutusunu genişletmek için yukarıdaki önekleri hangi denetimin üzerinde hiçbir karışıklığı böylece gerçekten kullanılıyor. Üretici lower-case bir kısaltması genellikle de öneki için eklenebilir. Örneğin, Visual Basic 3B çerçeve verebilir Professional'dan oluşturulan bir denetimi örneğinin fra3d öneki üzerinde denetim gerçekten kullanılan karışıklığı önlemek için kullanır. Bir komut düğmesini MicroHelp cmdm standart komut (cmd) düğmesini kullanarak bu ayırt etmek için kullanabilirsiniz. Üçüncü taraf denetimleriDenetimi, denetimin tam adını ve yazılım satıcısının adı için kullanılan öneki sağlayan bir uygulamada kullanılan her üçüncü tarafa ait bir denetim uygulamanın Genel Açıklama bölümünde listelenmelidir:Prefix Control Type Vendor cmdm Command Button MicroHelp Değişken ve yordamı adlandırmaDeğişken ve işlev adları aşağıdaki yapıya sahip: <prefix><body><qualifier><suffix>Part Description Example -------------------------------------------------------------------------- <prefix> Describes the use and scope of the variable. iGetRecordNext <body> Describes the variable. iGetNameFirst <qualifier> Denotes a derivative of the variable. iGetNameLast <suffix> The optional Visual Basic type character. iGetRecordNext% Aşağıdaki tablolar, Macarca C gösterimde üzerinde Windows için temel alan ad önekleri değişken ve işlevi tanımlar. Bu önekleri, tüm değişkenleri ve işlev adları kullanılmalıdır. Eski temel soneklerini kullanımını (% & # gibi, vb.) önerilmez. Değişken ve adının işlevi ekler:
Prefix Converged Variable Use Data Type Suffix
--------------------------------------------------------------------------
b bln Boolean Integer %
c cur Currency - 64 bits Currency @
d dbl Double - 64 bit Double #
signed quantity
dt dat Date and Time Variant
e err Error
f sng Float/Single - 32 Single !
bit signed
floating point
h Handle Integer %
i Index Integer %
l lng Long - 32 bit Long &
signed quantity
n int Number/Counter Integer %
s str String String $
u Unsigned - 16 bit Long &
unsigned quantity
udt User-defined type
vnt vnt Variant Variant
a Array
Kapsamı ve kullanımı ekler: Prefix Description g Global m Local to module or form st Static variable (no prefix) Non-static variable, prefix local to procedure v Variable passed by value (local to a routine) r Variable passed by reference (local to a routine) iSend - sayımını gönderilen iletilerin sayısını temsil eder. Bu değişken adlarının her söyleyin bir programcı çok farklı. Değişken adı için Gönder % azalır, bu bilgileri kaybolur. Kapsam önekleri g ve m de özellikle multi-developer projelerdeki ad çakışması sorununu azaltmak. bSend - son gönderme işlemi başarılı olarak tanımlayan BIR Boole bayrağı hSend - A tanıtıcı Comm arabirimi Macarca gösterimde Windows C programcıları tarafından da yaygın olarak kullanılan ve sürekli, Microsoft ürün belgeleri ve endüstri programlama defterlerindeki başvuruyor. Ayrıca, C programcıları Visual Basic kullanan programcılar arasındaki bononun Visual C++ geliştirme sistemi kazançları momentum çok daha güçlü olur. Bu geçiş ilk kez ve sık sık iki ortamları arasında geriye ve ileriye taşıma birçok programcılar için C'YE taşıma birçok Visual Basic programcıları neden olur. Değişken ve yordamı adları gövdesiGövde metni bir değişken veya günlük adı büyük/küçük harf kullanmalısınız ve amacını açıklamak gerektiği şekilde uzunluğunda olması gerekir. Buna ek olarak, işlev adları InitNameArray veya CloseDialog gibi bir fiil ile başlamalıdır.Sık kullanılan veya uzun koşulları adı uzunluğu makul kalmasını sağlamak için standart kısaltmaların önerilir. Değişken adları 32 karakterden daha genel olarak, VGA görüntüler üzerinde okunması zor olabilir. Kısaltmalar kullanarak, tüm uygulama tutarlı olduklarından emin olun. Rasgele sayı Say arasında geçiş yapma içinde bir proje için gereksiz karışıklığa yol açacaktır. Değişken ve yordamı adı niteleyicileriGenellikle ilgili değişkenleri ve yordamlar yönetmek ve ortak bir nesne işlemek için kullanılır. Bu gibi durumlarda, standart niteleyicileri türetilmiş değişkenleri ve yordamlar etiketlemek için kullanın. Gövde adının (sGetNameFirst gibi sGetNameLast sGetFirstName, sGetLastName yerine), biraz alışılmadık görünebilir sonra niteleyici geçirmeden olsa da bu uygulama sırası, Visual Basic Düzenleyicisi yordamında birlikte bu adları listeler, mantık ve uygulama yapısını anlamak kolaylaştırma yardımcı olur. Aşağıdaki tabloda, ortak niteleyicileri ve kendi standart anlamını tanımlar:
Qualifier Description (follows Body)
--------------------------------------------------------------------------
First First element of a set.
Last Last element of a set.
Next Next element in a set.
Prev Previous element in a set.
Cur Current element in a set.
Min Minimum value in a set.
Max Maximum value in a set.
Save Used to preserve another variable that must be reset later.
Tmp A "scratch" variable whose scope is highly localized within the
code. The value of a Tmp variable is usually only valid across
a set of contiguous statements within a single procedure.
Src Source. Frequently used in comparison and transfer routines.
Dst Destination. Often used in conjunction with Source.
Türler kullanıcı tanımlıKullanıcı tanımlı türlerinde, tümü büyük harf, simge adının sonuna eklenen _TYPE ile bildirir. Örneğin:Sabitleri adlandırmaSabit adlarını gövdesi, sözcükler arasında altçizgi (_) ile UPPER_CASE olmalıdır. Standart bir Visual Basic sabitleri Macarca bilgileri içermez, ancak önekleri istediğiniz i, <a2>s</a2>, <a4>g ve m değer ve bir sabit kapsamını anlamak için çok yararlı olabilir. Sabit adlarını değişkenleri olarak aynı kuralları izleyin. Örneğin:Variant veri türüBir değişkenin her zaman belirli bir türdeki verileri depolayacak biliyorsanız, bu tür bir değişkeni bildirmek için Visual Basic bu verileri daha verimli bir şekilde işleyebilir.Ancak, variant veri türü veritabanlarının, iletiler, DDE veya OLE ile çalışırken oldukça yararlı olabilir. Birçok veritabanı BOş bir alan için geçerli bir değer olarak izin ver. Kodunuzu NULL, 0 (sıfır) arasında ayrım yapmak gereken ve "" (boş dize). Çoğu zaman, bu tür işlemler, işlem veya verileri aktarmak için aldığı veri türünü bilmeniz gerekmez bir genel hizmet yordamı kullanabilirsiniz. Örneğin: Kodunuzu yorum oluşturmaTüm işlevler ve yordamlar (yaptığı) yordamını işlevsel özelliklerini açıklayan kısa bir açıklama ile başlamalıdır. Bunlar genellikle zamanla gereksiz açıklama bakım iş veya fotoğraflarının henüz sonucunda elde edilen hatalı yorumlar değişeceğinden bu açıklamayı (nasıl bunu yapar) uygulama ayrıntılarını açıklaması gerekir değil. Uygulama kodu kendisi ve gerekli bekleme ya da yerel açıklamaları da açıklanmıştır.Bir yordamına geçilen parametreler işlevlerini belirgin değildir ve yordam parametreleri, belirli bir aralıkta olmasını bekler açıklanan olması gerekir. Işlevi geri yordam (özellikle başvuru parametreleri) aracılığıyla değiştirilen genel değişkenleri ve değerler de her yordamına başında açıklanan gerekir. Bu (bkz: örnek sonraki bölüm "Bilgisayarınızı kod biçimlendirme") olduğu gibi olağan üstbilgi açıklama bloğu görünmelidir:
Section Comment Description
--------------------------------------------------------------------------
Purpose What the routine does (not how).
Inputs Each non-obvious parameter on a separate line with
in-line comments
Assumes List of each non-obvious external variable, control, open file,
and so on.
Returns Explanation of value returned for functions.
Effects List of each effected external variable, control, file, and
so on and the affect it has (only if this is not obvious)
Değişkenler, denetimleri ve yordamlar açıkça kadar satır içi yorum oluşturma yalnızca karmaşık veya sezgisel olmayan uygulama ayrıntılarını gerektiğini adlı olmalıdır. Birincil veri nesneler, yordamlar, algoritmaları, numaralandırma, uygulamanın bir genel bakış tanımı iletişim kutuları, veritabanı ve dosya sistemi bağımlılıklar ve projenin Visual Basic genel sabit bildirimlerini içeren .BAS modülün başlangıcında eklenmelidir. Not: Project pencere; bu nedenle, bu genel bakış bölümüne yalnızca en önemli dosyaları ve modüller hakkında bilgi sağlamak gereken bir projeden, dosyaları veya başlatma (.ını) veya veritabanı dosyaları gibi proje penceresi listelemiyor dosyaların listesini devralınarak açıklar. Kodunuzu biçimlendirmeBirçok Programcı hala VGA görüntüler kullandığından, ekran Emlak mümkün olduğunca mantığı yapısı ve iç içe geçirilmesi yansıtmak için biçimlendirme, kod hala verirken conserved gerekir.Standart, sekme, blok girintilerini iç içe geçmiş dörde iki boşluk olması gerekir. Dörtten fazla boşluk gereksizdir ve gizli veya yanlışlıkla kesildi neden. Ikiden az boşluk değil yeterince Göster mantığı iç içe geçirme. Microsoft Bilgi Bankası'ndaki bir üç alanı girinti kullanıyoruz. Varsayılan sekme Genişliği ayarlanacak ortam Seçenekler iletişim kutusunu kullanın. Bir yordam, işlev Genel Açıklama, bir boşluk girintilenir olmalıdır. Genel açıklamayı izleyen en yüksek düzey ifadeleri her girintili bir sekme olması gereken ek bir sekme iç içe geçmiş bloğu girintilenir. Örneğin: IşleçlerHer zaman dizeleri bitiştirmek bir ve işareti (&) kullanın ve artı işaretini (+), sayısal değerler ile çalışırken kullanın. Artı işareti (+) olmayan sayısal değerleri ile birlikte kullanarak, iki türevlerini üzerinde çalışırken sorunlarla karşılaşabilirsiniz. Örneğin,:KapsamOlası en küçük kapsamlı değişkenler her zaman tanımlanmış olmalıdır. Genel değişkenler, enormously karmaşık Durum makineleri oluşturmak ve bir uygulama mantığı bilmek son derece zor hale getirebilirsiniz. Genel değişkenleri de yeniden kullanma ve kod, bakım çok daha zorlaştırır. Visual Basic değişkenleri aşağıdaki kapsam olabilir:
Scope Variable Declared In: Visibility
--------------------------------------------------------------------------
Procedure-level Event procedure, sub, or Visible in the
function procedure in which
it is declared
Form-level, Declarations section of a form Visible in every
Module-level or code module (.FRM, .BAS) procedure in the
form or code
module
Global Declarations section of a code Always visible
module (.BAS, using Global
keyword)
Global değişkenler kullanmanız gerekiyorsa, tümünü tek bir modülde bildirdiğiniz ve işleviyle gruplandırabilmeniz için iyi bir yöntemdir. Modül GLOBAL.BAS gibi amacı gösteren anlamlı bir ad verin. Yalnızca genel değişkenler (değil geçirilmesi), yordamları ve işlevleri dışında için bunları geçirilen nesneler üzerinde çalışması. Yordam içinde kullanılan genel değişkenleri başına yordamının <a1>Genel Açıklama</a1> alanında tanımlanması. Buna ek olarak, geçirilen bağımsız değişkenin değeri değiştirmek istediğiniz sürece bağımsız değişkenleri altyordam ve fonksiyonları, ByVal geçirir. Mümkün oldukça modüler kodu yazın. Uygulama bir iletişim kutusu görüntülenirse, örneğin, denetimler ve tek bir formda iletişim'ın görevi gerçekleştirmek için gereken kod yerleştirin. Bu işlem yararlı bileşenlerine düzenlenmiş uygulama kodu tutmaya yardımcı olur ve kendi çal??ma ek yükünü en aza indirir. Üçüncü taraf denetimleriNot: aşağıda açıklanan ürünler Microsoft'tan bağımsız satıcılar tarafından üretilmektedir. Microsoft, örtük veya başka bir biçimde garanti, bu ürünlerin performansı veya güvenilirliği konusunda sağlar.Denetim önekleri ile kullanılacak standart bir üçüncü taraf satıcı adı Önek karakterlerine aşağıdaki tabloda listelenmiştir: Vendor Abbv ------------------------- MicroHelp (VBTools) m Pioneer Software p Crescent Software c Sheridan Software s Other (Misc) o
Control Control Abbr Vendor Example VBX File
Type Name Name
--------------------------------------------------------------------------
Alarm Alarm almm MicroHelp almmAlarm MHTI200.VBX
Animate Animate anim MicroHelp animAnimate MHTI200.VBX
Callback Callback calm MicroHelp calmCallback MHAD200.VBX
Combo Box DB_Combo cbop Pioneer cbopComboBox QEVBDBF.VBX
Combo Box SSCombo cbos Sheridan cbosComboBox SS3D2.VBX
Check Box DB_Check chkp Pioneer chkpCheckBox QEVBDBF.VBX
Chart Chart chtm MicroHelp chtmChart MHGR200.VBX
Clock Clock clkm MicroHelp clkmClock MHTI200.VBX
Button Command cmdm MicroHelp cmdmCommandButton MHEN200.VBX
Button
Button DB_Command cmdp Pioneer cmdpCommandButton QEVBDBF.VBX
Button (Group) Command cmgm MicroHelp cmgmBtton MHGR200.VBX
Button
(multiple)
Button Command cmim MicroHelp cmimCommandButton MHEN200.VBX
Button
(icon)
CardDeck CardDeck crdm MicroHelp crdmCard MHGR200.VBX
Dice Dice dicm MicroHelp dicmDice MHGR200.VBX
List Box (Dir) SSDir dirs Sheridan dirsDirList SS3D2.VBX
List Box (Drv) SSDrive drvs Sheridan drvsDriveList SS3D2.VBX
List Box (File) File List film MicroHelp filmFileList MHEN200.VBX
List Box (File) SSFile fils Sheridan filsFileList SS3D2.VBX
Flip Flip flpm MicroHelp flpmButton MHEN200.VBX
Scroll Bar Form Scroll fsrm MicroHelp fsrmFormScroll ???
Gauge Gauge gagm MicroHelp gagmGauge MHGR200.VBX
Graph Graph gpho Other gphoGraph XYGRAPH.VBX
Grid Q_Grid grdp Pioneer grdpGrid QEVBDBF.VBX
Scroll Bar Horizontal hsbm MicroHelp hsbmScroll MHEN200.VBX
Scroll Bar
Scroll Bar DB_HScroll hsbp Pioneer hsbpScroll QEVBDBF.VBX
Graph Histo hstm MicroHelp hstmHistograph MHGR200.VBX
Invisible Invisible invm MicroHelp invmInvisible MHGR200.VBX
List Box Icon Tag itgm MicroHelp itgmListBox MHAD200.VBX
Key State Key State kstm MicroHelp kstmKeyState MHTI200.VBX
Label Label (3d) lblm MicroHelp lblmLabel MHEN200.VBX
Line Line linm MicroHelp linmLine MHGR200.VBX
List Box DB_List lstp Pioneer lstpListBox QEVBDBF.VBX
List Box SSList lsts Sheridan lstsListBox SS3D2.VBX
MDI Child MDI Control mdcm MicroHelp mdcmMDIChild ???
Menu SSMenu mnus Sheridan mnusMenu SS3D3.VBX
Marque Marque mrqm MicroHelp mrqmMarque MHTI200.VB
Picture OddPic odpm MicroHelp odpmPicture MHGR200.VBX
Picture Picture picm MicroHelp picmPicture MHGR200.VBX
Picture DB_Picture picp Pioneer picpPicture QEVBDBF.VBX
Property Vwr Property pvrm MicroHelp pvrmPropertyViewer MHPR200.VBX
Viewer
Option (Group) DB_RadioGroup radp Pioneer radqRadioGroup QEVBDBF.VBX
Slider Slider sldm MicroHelp sldmSlider MHGR200.VBX
Button (Spin) Spinner spnm MicroHelp spnmSpinner MHEN200.VBX
Spreadsheet Spreadsheet sprm MicroHelp sprmSpreadsheet MHAD200.VBX
Picture Stretcher strm MicroHelp strmStretcher MHAD200.VBX
Screen Saver Screen Saver svrm MicroHelp svrmSaver MHTI200.VBX
Switcher Switcher swtm MicroHelp swtmSwitcher ???
List Box Tag tagm MicroHelp tagmListBox MHEN200.VBX
Timer Timer tmrm MicroHelp tmrmTimer MHTI200.VBX
ToolBar ToolBar tolm MicroHelp tolmToolBar MHAD200.VBX
List Box Tree trem MicroHelp tremTree MHEN200.VBX
Input Box Input (Text) txtm MicroHelp inpmText MHEN200.VBX
Input Box DB_Text txtp Pioneer txtpText QEVBDBF.VBX
Scroll Bar Vertical vsbm MicroHelp vsbmScroll MHEN200.VBX
Scroll Bar
Scroll Bar DB_VScroll vsbp Pioneer vsbpScroll QEVBDBF.VBX
Bu makaledeki bilginin uygulandığı durum:
Otomatik TercümeÖNEMLİ: Bu makale, bir kişi tarafından çevrilmek yerine, Microsoft makine-çevirisi yazılımı ile çevrilmiştir. Microsoft size hem kişiler tarafından çevrilmiş, hem de makine-çevrisi ile çevrilmiş makaleler sunar. Böylelikle, bilgi bankamızdaki tüm makalelere, kendi dilinizde ulaşmış olursunuz. Bununla birlikte, makine tarafından çevrilmiş makaleler mükemmel değildir. Bir yabancının sizin dilinizde konuşurken yapabileceği hatalar gibi, makale; kelime dağarcığı, söz dizim kuralları veya dil bilgisi açısından yanlışlar içerebilir. Microsoft, içeriğin yanlış çevrimi veya onun müşteri tarafından kullanımından doğan; kusur, hata veya zarardan sorumlu değildir. Microsoft ayrıca makine çevirisi yazılımını sıkça güncellemektedir. Makalenin İngilizcesi aşağıdaki gibidir:110264
(http://support.microsoft.com/kb/110264/en-us/
)
| Diğer Kaynaklar Diğer Destek Siteleri
ToplulukHemen Yardım AlMakale çevirileri
|






Windows Live
Facebook
Twitter
Linkedin
Digg it
Yahoo
Delicious
StumbleUpon
Yammer
Reddit
Technorati
FriendFeed
Email



Üste