Αναγν. άρθρου: 110264 - Τελευταία αναθεώρηση: Πέμπτη, 26 Μαΐου 2011 - Αναθεώρηση: 4.0

ΠΛΗΡΟΦΟΡΙΕΣ: Microsoft διαβουλεύσεων με υπηρεσίες συμβάσεις ονομασίας της Visual Basic

Παράλληλη προβολήΠροβολή του πρωτότυπου αγγλικού άρθρου και της ελληνικής μετάφρασης αντικριστά
Μηχανικά μεταφρασμένοΠΡΟΕΙΔΟΠΟΙΗΣΗ: ΑΥΤΟ ΤΟ ΑΡΘΡΟ ΜΕΤΑΦΡΑΣΤΗΚΕ ΜΕ ΜΗΧΑΝΙΚΗ ΜΕΤΑΦΡΑΣΗ
Retired KB ArticleΑποποίηση ευθυνών για περιεχόμενο της Γνωσιακής Βάσης (KB) που έχει αποσυρθεί
Δείτε τα προϊόντα στα οποία αναφέρεται το συγκεκριμένο άρθρο.
Συμβουλή συστήματοςΑυτό το άρθρο ισχύει για διαφορετικό λειτουργικό σύστημα από αυτό που χρησιμοποιείτε. Το περιεχόμενο του άρθρου που ενδέχεται να μην σας αφορά έχει απενεργοποιηθεί.

Σε αυτήν τη σελίδα

Ανάπτυξη όλων | Σύμπτυξη όλων

Περίληψη

Είναι καλή ιδέα να δημιουργήσετε συμβάσεις ονομασίας για Visual Basic Κωδικός. Αυτό το άρθρο σας δίνει τις συμβάσεις ονομασίας που χρησιμοποιούνται από τη Microsoft Συμβουλευτικές υπηρεσίες (MCS).

Αυτό το έγγραφο είναι ένα υπερσύνολο των συμβάσεων κώδικα Visual Basic στο Visual Basic "Programmer's Guide".

ΣΗΜΕΊΩΣΗ: Τα στοιχεία ελέγχου τρίτων κατασκευαστών που αναφέρονται σε αυτό το άρθρο έχουν κατασκευαστεί από προμηθευτές που είναι ανεξάρτητοι της Microsoft. Η Microsoft δεν παρέχει καμία εγγύηση, σιωπηρή ή άλλη, όσον αφορά τις επιδόσεις ή την αξιοπιστία αυτά τα στοιχεία ελέγχου.
Επιστροφή στην αρχή

Περισσότερες πληροφορίες

Συμβάσεις ονομασίας βοηθούν τους προγραμματιστές Visual Basic:

  • τυποποίηση της δομής, κωδικοποίηση στυλ και λογική μιας εφαρμογής.
  • Για να δημιουργήσετε ακριβείς, ευανάγνωστες και σαφείς πηγαίο κώδικα.
  • είναι σύμφωνες με τις άλλες συμβάσεις γλώσσας (το πιο σημαντικό το Οδηγός προγραμματιστές Visual Basic και βασική Ουγγρικά c των Windows Σημείωση).
  • αποτελεσματική από το μέγεθος της συμβολοσειράς και ανταλλακτικών άποψη, επιτρέποντας έτσι σε μεγαλύτερη ευκαιρία για ονόματα αντικειμένων περισσότερο και πληρέστερη.
  • Ορίστε τις ελάχιστες απαιτήσεις που είναι απαραίτητες για τα παραπάνω.
Επιστροφή στην αρχή

Ρύθμιση των επιλογών περιβάλλοντος

Χρησιμοποιήστε την επιλογή ρητή. Να δηλώσετε όλες τις μεταβλητές για να αποθηκεύσετε προγραμματισμού χρόνου από μείωση του αριθμού των σφαλμάτων που προκαλούνται από σφάλματα πληκτρολόγησης (για παράδειγμα, aUserNameTmp vs. sUserNameTmp και sUserNameTemp). Στο παράθυρο διαλόγου Επιλογές περιβάλλον, ορισμός Απαιτείται δήλωση μεταβλητών "Ναι". Απαιτεί πρόταση Option Explicit Μπορείτε να δηλώσετε όλες τις μεταβλητές στο πρόγραμμα Visual Basic. Αποθήκευση αρχείων ως κείμενο ASCII. Αποθήκευση φόρμας (.FRM) και λειτουργική μονάδα (.Αρχεία BAS) ως ASCII κείμενο για να διευκολύνει τη χρήση της έκδοσης συστημάτων ελέγχου και να ελαχιστοποιήσετε το ζημία που προκαλείται από την καταστροφή του δίσκου. Επιπλέον, μπορείτε να:

  • Χρησιμοποιήστε το δικό σας πρόγραμμα επεξεργασίας
  • χρησιμοποιήσετε τα αυτοματοποιημένα εργαλεία, όπως grep
  • Δημιουργία ΥΠΌΘΕΣΗΣ εργαλεία ή κώδικα της Visual Basic
  • εκτέλεση εξωτερικών ανάλυσης κώδικα της Visual Basic
Για να έχετε πάντα αποθήκευση αρχείων ως κείμενο ASCII, από το περιβάλλον της Visual Basic Παράθυρο διαλόγου Επιλογές, ορίστε επιλογή προεπιλεγμένη αποθήκευση ως μορφή κειμένου.
Επιστροφή στην αρχή

Αντικείμενο συνθήκες ονοματοθεσίας για αντικείμενα τυπική

Οι παρακάτω πίνακες ορίζουν τα προθέματα MCS αντικείμενο τυπικό όνομα. Αυτές προθέματα είναι σύμφωνες με αυτές που τεκμηριώνονται στη Visual Basic Οδηγού για προγραμματιστές.
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
Επιστροφή στην αρχή

Αντικείμενο ονοματοθεσίας για αντικείμενα της βάσης δεδομένων

Prefix        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
ΣΗΜΕΊΩΣΗ: Χρησιμοποιώντας ένα επίθημα για ερωτήματα επιτρέπει κάθε ερωτήματος ταξινομούνται με την συσχετισμένο πίνακα σε παράθυρα διαλόγου Microsoft Access (Προσθήκη πίνακα, λίστα πινάκων Στιγμιότυπο).
Επιστροφή στην αρχή

Συμβάσεις ονομασίας μενού

Οι εφαρμογές χρησιμοποιούν συχνά μια αφθονία μενού στοιχείων ελέγχου. Ως αποτέλεσμα, μπορείτε χρειάζεστε ένα διαφορετικό σύνολο συμβάσεις ονομασίας για αυτά τα στοιχεία ελέγχου. Μενού ελέγχου θα πρέπει να επεκταθεί πέρα από την αρχική mnu ετικέτα προθέματα, προσθέτοντας μια πρόσθετες πρόθεμα για κάθε επίπεδο ένθεσης με λεζάντα τελική μενού σε στο τέλος της συμβολοσειράς του ονόματος. Για παράδειγμα:
Menu Caption Sequence   Menu Handler Name
Help.Contents           mnuHelpContents
File.Open               mnuFileOpen
Format.Character        mnuFormatCharacter
File.Send.Fax           mnuFileSendFax
File.Send.Email         mnuFileSendEmail
Όταν χρησιμοποιείται η παρούσα σύμβαση, όλα τα μέλη μιας ομάδας συγκεκριμένο μενού είναι στη λίστα δίπλα στο άλλο στα πλαίσια αναπτυσσόμενης λίστας αντικείμενο (στον κώδικα και η ιδιότητα παράθυρο). Επιπλέον, το στοιχείο ελέγχου μενού ονόματα σαφώς Τεκμηριώστε τα στοιχεία μενού, στο οποίο είναι συνδεδεμένος.
Επιστροφή στην αρχή

Συμβάσεις ονομασίας για άλλα στοιχεία ελέγχου

Για τα νέα στοιχεία που δεν αναφέρονται ανωτέρω, δοκιμάστε με μοναδικό τρία πρόθεμα χαρακτήρα. Ωστόσο, είναι πιο σημαντικό να καταργήστε την επιλογή από το να εξέχει τρεις χαρακτήρες.

Παράγωγα στοιχεία ελέγχου, όπως ένα πλαίσιο λίστας βελτιωμένη, επεκτείνετε τα προθέματα πάνω από αυτό που δεν γίνεται σύγχυση μέσω της οποίας γίνεται πραγματικά ελέγχου χρησιμοποιείται. Θα επίσης συνήθως εχορήγησε συντομογραφία για τον κατασκευαστή η προσθήκη του προθέματος. Για παράδειγμα, δημιουργείται μια παρουσία του στοιχείου ελέγχου από το Visual Basic Professional 3D πλαίσιο θα μπορούσε να χρησιμοποιεί το πρόθεμα fra3d για την αποφυγή μέσω της οποίας ελέγχου πραγματικά χρησιμοποιείται σύγχυση. Ένα κουμπί εντολής από MicroHelp ήταν δυνατή η χρήση cmdm για να διαφοροποιήσετε από την τυπική εντολή κουμπί (cmd).
Επιστροφή στην αρχή

Στοιχεία ελέγχου άλλου κατασκευαστή

Κάθε στοιχείο ελέγχου άλλου κατασκευαστή που χρησιμοποιείται σε μια εφαρμογή, θα πρέπει να παρατίθενται στο του ενότητα σχόλιο της εφαρμογής επισκόπηση, παρέχοντας το πρόθεμα που χρησιμοποιείται για την στοιχείο ελέγχου, το πλήρες όνομα του στοιχείου ελέγχου και το όνομα του προμηθευτή λογισμικού:
Prefix    Control Type        Vendor
cmdm      Command Button      MicroHelp
Επιστροφή στην αρχή

Μεταβλητή και ρουτίνα ονομασίας

Ονόματα μεταβλητής και συνάρτηση έχει την ακόλουθη δομή:<prefix><body><qualifier><suffix> </suffix></qualifier></body></prefix>
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%
Προθέματα:

Οι παρακάτω πίνακες ορίζουν προθέματα όνομα μεταβλητής και τη λειτουργία που είναι βασίζεται σε σύστημα Ουγγρικά c για τα Windows. Πρέπει να χρησιμοποιούνται αυτά τα προθέματα με όλες τις μεταβλητές και ονόματα συναρτήσεων. Χρήση παλιό βασικό επιθήματα (όπως π.χ. %, & #, κ.λπ.) Οι αποφεύγεται με κάθε τρόπο.

Μεταβλητή και προθέματα όνομα συνάρτησης:
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
ΣΗΜΕΊΩΣΗ: οι τιμές της στήλης Converged αντιπροσωπεύουν τις προσπάθειες Συγκεντρώστε τα πρότυπα ονομασίας της Visual Basic, Visual Basic for Applications, και Η Access Basic. Είναι πιθανό ότι αυτά τα προθέματα θα αποτελέσει Microsoft πρότυπα σε ορισμένα σημείο στο προσεχές μέλλον.

Πεδίο εφαρμογής και χρήσης προθέματα:
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)
Ουγγρικά σημειογραφία είναι ως πολύτιμο σε Visual Basic ως C. Αν και τα επιθήματα τύπου Visual Basic δηλώνει μια μεταβλητή τύπου δεδομένων, να κάνουν Εξηγεί τι μια μεταβλητή ή συνάρτηση χρησιμοποιείται για ή πώς μπορεί να είναι πρόσβαση. Ακολουθούν μερικά παραδείγματα:
iSend - αντιπροσωπεύει μια καταμέτρηση του αριθμού των μηνυμάτων που αποστέλλονται
bSend - Boolean μια σημαία ορίζει την επιτυχία την τελευταία λειτουργία αποστολής
hSend - A χειρισμού διασύνδεση επικοινωνίας
Καθένα από αυτά τα ονόματα των μεταβλητών πείτε προγραμματιστής κάτι πολύ διαφορετικό. Αυτές οι πληροφορίες χάνονται όταν μειώνεται το όνομα της μεταβλητής % αποστολής. Πεδίο εφαρμογής προθέματα όπως g και m επίσης μειώσει το πρόβλημα ασυμφωνίας όνομα ειδικά σε multi-developer έργα.

Ουγγρικά σημειογραφία χρησιμοποιείται επίσης ευρέως από προγραμματιστές Windows C και συνεχώς αναφέρεται στην τεκμηρίωση προϊόντος της Microsoft και στη βιομηχανία βιβλία προγραμματισμού. Επιπλέον, το ομόλογο μεταξύ προγραμματιστές c και Οι προγραμματιστές που χρησιμοποιούν Visual Basic θα γίνουν πολύ ισχυρότερες ως το Visual Σύστημα ανάπτυξης C++ αποκτά ορμή. Μετάβαση αυτή θα έχει ως αποτέλεσμα πολλές Μετακίνηση c για πρώτη φορά και πολλοί προγραμματιστές Visual Basic Οι προγραμματιστές συχνά μετακίνηση εμπρός και πίσω μεταξύ δύο περιβάλλοντα.
Επιστροφή στην αρχή

Το σώμα της μεταβλητής και ονόματα ρουτίνα

Το σώμα του μια μεταβλητή ή ρουτίνα όνομα πρέπει να χρησιμοποιήσετε κεφαλαία και πεζά και θα πρέπει να όσο χρειάζεται για να περιγράψετε το σκοπό. Επιπλέον, λειτουργούν ονόματα πρέπει να αρχίζουν με ένα ρήμα, όπως InitNameArray ή CloseDialog.

Για όρους χρησιμοποιείται συχνά ή μεγάλο, συνιστώνται τυπική συντομογραφίες Για να διατηρήσετε το όνομα μήκη εύλογη. Γενικά, η μεταβλητή ονόματα μεγαλύτερη από 32 χαρακτήρες μπορεί να είναι δύσκολο να διαβαστεί στις εμφανίζει VGA.

Όταν χρησιμοποιείτε τις συντομογραφίες, βεβαιωθείτε ότι είναι συνεπή σε όλη την ολόκληρη την εφαρμογή. Τυχαία εναλλαγή μεταξύ Cnt και πλήθος μέσα σε ένα το Project θα οδηγήσει σε σύγχυση περιττές.
Επιστροφή στην αρχή

Τα προσδιοριστικά στην μεταβλητή και ονόματα ρουτίνα

Σχετικά με μεταβλητές και ρουτίνες χρησιμοποιούνται συχνά για να διαχειριστείτε και να χειριστείτε ένα κοινό αντικείμενο. Στις περιπτώσεις αυτές, χρησιμοποιήστε τυπικά προσδιοριστικά στην ετικέτα του παράγωγα μεταβλητές και ρουτίνες. Παρόλο που το προσδιοριστικό μετά την τοποθέτηση του σώμα το όνομα μπορεί να φαίνεται λίγο άκομψες (όπως στο sGetNameFirst, sGetNameLast αντί για sGetFirstName, sGetLastName), η πρακτική αυτή θα Βοήθεια παραγγείλετε αυτά τα ονόματα μαζί στις συνήθεις λίστες πρόγραμμα επεξεργασίας Visual Basic, διευκολύνοντας τη λογική και τη δομή της εφαρμογής για να κατανοήσετε. Ο ακόλουθος πίνακας καθορίζει κοινά προσδιοριστικά και βασική σημασία τους:
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.
Επιστροφή στην αρχή

Τύποι καθοριζόμενοι από το χρήστη

Δηλώνουν ορίζονται από το χρήστη τύπους όλο με κεφαλαία με προσαρτημένο στο τέλος της _TYPE το όνομα του συμβόλου. Για παράδειγμα:
Type CUSTOMER_TYPE
      sName As String
      sState As String * 2
      lID as Long
   End Type
Όταν δηλώνοντας μια μεταβλητή περιόδου λειτουργίας ενός χρήστη καθορίζεται τύπος, να προσθέσετε ένα πρόθεμα για το όνομα της μεταβλητής τον τύπο αναφοράς. Για παράδειγμα:
   Dim custNew as CUSTOMER_TYPE
Επιστροφή στην αρχή

Ονομασία σταθερές

Ο οργανισμός σταθερά ονόματα πρέπει να είναι UPPER_CASE με χαρακτήρες υπογράμμισης (_) μεταξύ των λέξεων. Παρόλο που δεν περιλαμβάνουν τυπικά σταθερών της Visual Basic Ουγγρικά πληροφορίες προθέματα όπως i, s, g και m μπορεί να είναι πολύ χρήσιμα σε Κατανόηση της τιμής και εμβέλεια σταθερά. Για τα ονόματα των σταθερών, ακολουθήστε τους ίδιους κανόνες με μεταβλητές. Για παράδειγμα:
<mnUSER_LIST_MAX   ' Max entry limit for User list (integer value,
                     ' local to module)
   gsNEW_LINE        ' New Line character string (global to entire
                     ' application)
Επιστροφή στην αρχή

Τύπος δεδομένων VARIANT

Εάν γνωρίζετε ότι μια μεταβλητή πάντα θα αποθηκεύσει τα δεδομένα ενός συγκεκριμένου τύπου, Visual Basic μπορεί να χειριστεί τα δεδομένα πιο αποτελεσματικά Εάν δηλώσετε μια μεταβλητή αυτού του τύπου.

Ωστόσο, ο τύπος δεδομένων variant μπορεί να είναι εξαιρετικά χρήσιμο όταν εργάζεστε με βάσεις δεδομένων, μηνύματα, DDE ή OLE. Πολλές βάσεις δεδομένων επιτρέπουν NULL ως έγκυρη η τιμή για ένα πεδίο. Ο κώδικάς σας πρέπει να γίνεται διάκριση μεταξύ NULL, 0 (μηδέν) και "" (κενή συμβολοσειρά). Πολλές φορές, να χρησιμοποιήσετε αυτούς τους τύπους λειτουργιών σε ρουτίνα υπηρεσίας γενικής χρήσης που πρέπει να γνωρίζετε τον τύπο δεδομένων του λαμβάνει να επεξεργαστεί ή να περνούν τα δεδομένα. Για παράδειγμα:
   Sub ConvertNulls(rvntOrg As Variant, rvntSub As Variant)
      ' If rvntOrg = Null, replace the Null with rvntSub
      If IsNull(rvntOrg) Then rvntOrg = rvntSub
   End Sub
Το Ωστόσο, υπάρχουν ορισμένα μειονεκτήματα, χρησιμοποιώντας παραλλαγές. Κωδικός δηλώσεις που χρήση παραλλαγών μερικές φορές μπορεί να είναι ασαφές τον προγραμματιστή. Για παράδειγμα:
   vnt1 = "10.01" : vnt2 = 11 : vnt3 = "11" : vnt4 = "x4"
   vntResult = vnt1 + vnt2  ' Does vntResult = 21.01 or 10.0111?
   vntResult = vnt2 + vnt1  ' Does vntResult = 21.01 or 1110.01?
   vntResult = vnt1 + vnt3  ' Does vntResult = 21.01 or 10.0111?
   vntResult = vnt3 + vnt1  ' Does vntResult = 21.01 or 1110.01?
   vntResult = vnt2 + vnt4  ' Does vntResult = 11x4 or ERROR?
   vntResult = vnt3 + vnt4  ' Does vntResult = 11x4 or ERROR?
Τα παραπάνω παραδείγματα είναι πολύ λιγότερο ασαφής και ευκολότερη την ανάγνωση, debug, και να διατηρήσετε εάν χρησιμοποιήθηκαν οι ρουτίνες μετατροπής τύπου Visual Basic αντί για αυτό. Για παράδειγμα:
   iVar1 = 5 + val(sVar2)   ' use this (explicit conversion)
   vntVar1 = 5 + vntVar2    ' not this (implicit conversion)
Επιστροφή στην αρχή

Σχολιασμός του κώδικα

Θα πρέπει να ξεκινά με ένα σύντομο σχόλιο που περιγράφει όλες τις διαδικασίες και συναρτήσεις λειτουργικά χαρακτηριστικά της ρουτίνας (λειτουργία). Αυτό περιγραφή θα πρέπει να περιγράφουν τις λεπτομέρειες υλοποίησης (πώς το κάνει) Επειδή αυτές συχνά αλλάζουν καιρό, με αποτέλεσμα περιττών σχόλιο εργασίες συντήρησης ή άλλα χειρότερα ακόμη, εσφαλμένη σχόλια. Ο κωδικός τον εαυτό και οποιαδήποτε είναι απαραίτητο σε γραμμή ή τοπικό σχόλια θα περιγράφουν την εφαρμογή.

Πρέπει να περιγράφονται οι παράμετροι που διαβιβάστηκε σε μια ρουτίνα όταν οι λειτουργίες τους δεν είναι προφανής και όταν η ρουτίνα αναμένει παραμέτρους σε μια συγκεκριμένη περιοχή. Λειτουργία τιμές επιστροφής και τις καθολικές μεταβλητές που τροποποιήθηκαν από το ρουτίνα (ιδίως μέσω παραμέτρους αναφοράς) πρέπει να περιγράφεται επίσης στο στην αρχή κάθε ρουτίνα.

Σχόλιο ρουτίνας κεφαλίδα μπλοκ θα πρέπει να φαίνεται όπως αυτό (βλέπε επόμενη ενότητα "Μορφοποίηση κώδικα σας" για ένα παράδειγμα):
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)
Κάθε μη trivial δήλωση μεταβλητής πρέπει να περιλαμβάνει ένα σχόλιο στη γραμμή Περιγράφει τη χρήση της μεταβλητής που έχει δηλωθεί.

Μεταβλητές, στοιχεία ελέγχου και ρουτίνες πρέπει να ονομάζεται αρκετή σαφήνεια που σε- γραμμή σχολιασμού είναι απαραίτητη μόνο για εφαρμογή πολύπλοκων ή μη διαισθητικό λεπτομέρειες.

Μια περιγραφή Επισκόπηση της εφαρμογής, απαρίθμηση κύριων δεδομένων αντικείμενα, ρουτίνες, αλγορίθμους, παράθυρα διαλόγου, βάση δεδομένων και αρχείο συστήματος εξαρτήσεις και ούτω καθεξής πρέπει να συμπεριληφθούν στην αρχή της.Λειτουργική μονάδα BAS που περιέχει το έργο Visual Basic γενική σταθερή δηλώσεις.

ΣΗΜΕΊΩΣΗ: Το παράθυρο του έργου εγγενώς περιγράφει τη λίστα των αρχείων σε ένα έργο, έτσι ώστε αυτή η ενότητα Επισκόπηση πρέπει μόνο να παρέχουν πληροφορίες σχετικά με το πιο σημαντικά αρχεία και λειτουργικές μονάδες ή τα αρχεία στο παράθυρο του έργου δεν λίστα, όπως η προετοιμασία (.INI) ή αρχεία βάσης δεδομένων.
Επιστροφή στην αρχή

Μορφοποίηση του κώδικά σας

Επειδή πολλοί προγραμματιστές χρησιμοποιούν εξακολουθεί να εμφανίζει VGA, πρέπει να είναι η οθόνη ακινήτων η συντήρηση όσο είναι δυνατό, ενώ εξακολουθεί να επιτρέπει μορφοποίησης για κώδικα απεικονίζει τη λογική δομή και ένθεση.

Βασική, με βάση το tab μπλοκ ένθεση εσοχές πρέπει να είναι δύο έως τέσσερα κενά διαστήματα. Περισσότερες από τέσσερις χώροι είναι απαραίτητη και μπορεί να προκαλέσει δηλώσεις είναι κρυφά ή περικομμένη κατά λάθος. Δεν έχει λιγότερο από δύο διαστήματα Εμφάνιση επαρκώς ένθεση λογική. Της Microsoft Knowledge Base, χρησιμοποιούμε ένα εσοχή τριών χώρο. Χρησιμοποιήστε το παράθυρο διαλόγου Επιλογές περιβάλλοντος για να ορίσετε την προεπιλεγμένη πλάτος στηλοθέτη.

Σχόλιο λειτουργική επισκόπηση μια ρουτίνα πρέπει να διαμορφώνονται κατά ένα διάστημα. Θα πρέπει να είναι το υψηλότερο επίπεδο δηλώσεις που ακολουθούν το σχόλιο Επισκόπηση εσοχή μία καρτέλα με κάθε ένθετο μπλοκ εσοχή πρόσθετη καρτέλα. Για παράδειγμα:
**************************************************************************
'Purpose:   Locate first occurrence of a specified user in UserList array.
'Inputs:    rasUserList():  the list of users to be searched
'           rsTargetUser:   the name of the user to search for
'Returns:   the index of the first occurrence of the rsTargetUser
'           in the rasUserList array. If target user not found, return -1.
'**************************************************************************

'VB3Line: Enter the following lines as one line
Function iFindUser (rasUserList() As String, rsTargetUser as String) _
   As Integer
   Dim i As Integer           ' loop counter
   Dim bFound As Integer      ' target found flag
   iFindUser = -1
   i = 0
   While i <= Ubound(rasUserList) and Not bFound
      If rasUserList(i) = rsTargetUser Then
         bFound = True
         iFindUser = i
      End If
   Wend
End Function
Μεταβλητών και σταθερών μη γενικό πρέπει να ομαδοποιηθούν οι συνάρτηση αντί από από τη διαίρεση σε απομονωμένες περιοχές ή ειδικά αρχεία. Visual Basic γενική σταθερές όπως ΚΛΕΨΎΔΡΑ πρέπει να είναι ομαδοποιημένα σε μια μεμονωμένη λειτουργική μονάδα (VB_STD.BAS) για να διατηρείτε ξεχωριστά από δηλώσεις συγκεκριμένη εφαρμογή.
Επιστροφή στην αρχή

Τελεστές

Πάντα να χρησιμοποιήσετε ένα εμπορικό και (&) κατά τη συνένωση συμβολοσειρών όπως και χρησιμοποιήσετε συν σύμβολο (+), όταν εργάζεστε με αριθμητικές τιμές. Με ένα σύμβολο συν (+) μη αριθμητικές τιμές, ενδέχεται να προκαλέσει προβλήματα όταν λειτουργεί σε δύο παραλλαγές. Για παράδειγμα:
   vntVar1 = "10.01"
   vntVar2 = 11
   vntResult = vntVar1 + vntVar2         ' vntResult =  21.01
   vntResult = vntVar1 & vntVar2         ' vntResult = 10.0111
Επιστροφή στην αρχή

Πεδίο εφαρμογής

Μεταβλητές πρέπει πάντα να ορίζονται με το μικρότερο δυνατό πεδίο. Να δημιουργήσετε υπολογιστές enormously πολύπλοκων κατάστασης και να κάνετε καθολικές μεταβλητές του λογική εφαρμογής εξαιρετικά δύσκολο να κατανοήσετε. Καθολικές μεταβλητές Επίσης βεβαιωθείτε την επαναχρησιμοποίηση και τη διατήρηση του κώδικά σας πολύ πιο δύσκολο. Μεταβλητές σε Visual Basic μπορούν να έχουν το ακόλουθο πεδίο:
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)
Σε μια εφαρμογή της Visual Basic, χρησιμοποιήστε μόνο καθολικών μεταβλητών όταν υπάρχει καμία άλλες βολικό τρόπο για κοινή χρήση δεδομένων μεταξύ φορμών. Θέλετε να εξετάσετε αποθήκευση πληροφοριών στην ιδιότητα Tag του στοιχείου ελέγχου, το οποίο μπορεί να προσπελαστεί καθολικά χρησιμοποιώντας τη σύνταξη form.object.property.

Εάν χρησιμοποιείτε καθολικές μεταβλητές, είναι καλή πρακτική να δηλώνετε όλες τους σε μια μεμονωμένη λειτουργική μονάδα και την ομάδα από τη συνάρτηση. Δώστε τη λειτουργική μονάδα σε χαρακτηριστικό όνομα που υποδεικνύει το σκοπό, όπως GLOBAL.BAS.

Με εξαίρεση τις καθολικές μεταβλητές (η οποία δεν πρέπει να μεταβιβαστούν) συναρτήσεις και διαδικασίες πρέπει να λειτουργήσει μόνο σε αντικείμενα που μεταβιβάζονται τους. Καθολικές μεταβλητές που χρησιμοποιούνται σε ρουτίνες πρέπει να προσδιορίζονται στο περιοχή γενικό σχόλιο στην αρχή τη ρουτίνα. Επιπλέον, έχει περάσει ορίσματα συναρτήσεων χρησιμοποιώντας ByVal, εκτός αν θέλετε να ρητά και εκτέλεση υπορουτινών Αλλάξτε την τιμή του ορίσματος που διαβιβάστηκε.

Εγγραφή αρθρωτού κώδικα όποτε είναι δυνατό. Για παράδειγμα, εάν η εφαρμογή σας Εμφανίζει ένα παράθυρο διαλόγου, τοποθετήσετε όλα τα στοιχεία ελέγχου και απαιτείται για την εκτέλεση κώδικα στο παράθυρο διαλόγου εργασιών σε μια μεμονωμένη φόρμα. Αυτό σας βοηθά να διατηρήσετε την εφαρμογή κωδικός οργανωμένες σε χρήσιμα στοιχεία και ελαχιστοποιεί την επιβάρυνση του χρόνου εκτέλεσης.
Επιστροφή στην αρχή

Στοιχεία ελέγχου άλλου κατασκευαστή

ΣΗΜΕΊΩΣΗ: Τα προϊόντα που αναφέρονται κατωτέρω έχουν κατασκευαστεί από προμηθευτές που είναι ανεξάρτητοι της Microsoft. Η Microsoft δεν παρέχει καμία εγγύηση, σιωπηρή ή διαφορετικά, όσον αφορά επιδόσεις ή αξιοπιστία αυτών των προϊόντων.

Ο παρακάτω πίνακας παραθέτει το πρόθεμα ονόματος τυπική τρίτο προμηθευτή να χρησιμοποιείται με χαρακτήρες ελέγχου προθέματα:
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
Επιστροφή στην αρχή
Οι πληροφορίες σε αυτό το άρθρο ισχύουν για:
  • Microsoft Visual Basic 4.0 Standard Edition
  • Microsoft Visual Basic 4.0 Professional Edition
  • Microsoft Visual Basic 2.0 Standard Edition
  • Microsoft Visual Basic 3.0 Professional Edition
  • Microsoft Visual Basic 2.0 Professional Edition
Επιστροφή στην αρχή
Λέξεις-κλειδιά: 
kb3rdparty kbdocs kbinfo kbprogramming kbref kbtophit kbmt KB110264 KbMtel
Επιστροφή στην αρχή
Μηχανικά μεταφρασμένοΜηχανικά μεταφρασμένο
ΣΗΜΑΝΤΙΚΟ: Αυτό το άρθρο είναι προϊόν λογισμικού μηχανικής μετάφρασης της Microsoft και όχι ανθρώπινης μετάφρασης. Η Microsoft σάς προσφέρει άρθρα που είναι προϊόντα ανθρώπινης αλλά και μηχανικής μετάφρασης έτσι ώστε να έχετε πρόσβαση σε όλα τα άρθρα της Γνωσιακής Βάσης μας στη δική σας γλώσσα. Ωστόσο, ένα άρθρο που έχει προκύψει από μηχανική μετάφραση δεν είναι πάντα άριστης ποιότητας. Ενδέχεται να περιέχει λεξιλογικά, συντακτικά ή γραμματικά λάθη, όπως ακριβώς τα λάθη που θα έκανε ένας μη φυσικός ομιλητής επιχειρώντας να μιλήσει τη γλώσσα σας. Η Microsoft δεν φέρει καμία ευθύνη για τυχόν ανακρίβειες, σφάλματα ή ζημίες που προκύψουν λόγω τυχόν παρερμηνειών στη μετάφραση του περιεχομένου ή χρήσης του από τους πελάτες της. Επίσης, η Microsoft πραγματοποιεί συχνά ενημερώσεις στο λογισμικό μηχανικής μετάφρασης.
Η αγγλική έκδοση αυτού του άρθρου είναι η ακόλουθη:110264  (http://support.microsoft.com/kb/110264/en-us/ )
Επιστροφή στην αρχή
Retired KB ArticleΑποποίηση ευθυνών για περιεχόμενο της Γνωσιακής Βάσης (KB) που έχει αποσυρθεί
This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.
Επιστροφή στην αρχή