OVH Cloud OVH Cloud

Nomenclature des variables

5 réponses
Avatar
Esperanza
Bonjour C# expert !!

Étant débutante en C# et voulant commencer du bon pied, je cherche une liste
de la bonne nomenclature des variables et objets à utiliser dans mon code.
Je n'ai rien trouver de significatif sur le site de microsoft.

Merci de partager vos connaissances !!

Esperanza

5 réponses

Avatar
Elp
On Fri, 7 Jan 2005 10:58:18 -0500, Esperanza wrote:

Bonjour C# expert !!

Étant débutante en C# et voulant commencer du bon pied, je cherche une liste
de la bonne nomenclature des variables et objets à utiliser dans mon code.
Je n'ai rien trouver de significatif sur le site de microsoft.



Tu trouvera pas mal de trucs ici:
<http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconnamingguidelines.asp>
Avatar
Patrick Philippot
Esperanza wrote:
Étant débutante en C# et voulant commencer du bon pied, je cherche
une liste de la bonne nomenclature des variables et objets à utiliser
dans mon code. Je n'ai rien trouver de significatif sur le site de
microsoft.



Bonjour,

Ah, je sens que nous allons réveiller une vieille discussion: notation
hongroise ou pas notation hongroise?

La notation hongroise consiste à préfixer le nom d'une variable ou d'un
membre d'une classe avec une ou plusieurs lettres minuscules indiquant
son type. Quelques exemples:

lpszMaChaine (pointeur vers une chaine ASCIIZ)
nValeur (variable de type entier)
cCount (compte d'octets)

Bien que je sois toujours partisan de cette notation, il faut avouer
qu'elle est moins utile dans un environnement (VS .Net) où il est très
facile de visualiser le type d'une donnée (mais tout le monde n'utilise
pas Visual Studio ou un IDE avec des capacités équivalentes). En outre,
il est malpratique (voire inopportun, à cause d'Intellisense) d'utiliser
cette notation pour les membres publics d'une classe. Par ailleurs,
cette notation n'est pas utilisée dans la bibliothèque .Net.

Le consensus semble donc se faire autour d'une nomenclature de type
CamelCase sans préfixe.

Par contre, l'utilisation judicieuse des namespaces fait partie des
points importants. Une hiérarchie cohérente dans laquelle il est facile
de naviguer et de retrouver un élément particulier est probablement
aujourd'hui plus importante qu'une nomenclature très rigoureuse. Le
choix du nom du namespace racine pour vos classes (en général le nom de
l'entreprise ou du département) ainsi que celui des sous-espaces devra
donc être fait avec soin.

--
Patrick Philippot - Microsoft MVP
MainSoft Consulting Services
www.mainsoft.fr
Avatar
Simon Mourier [MS]
Sur la notation hongroise, le préfixe, à l'origine, ne code surtout pas le
type exact mais un "genre" de données. C'est pourquoi on aurait plutôt écrit
en effet:

int nCount;

et non pas

int iCount;

Et c'était donc relativement portable (8->16->32bits, etc...), mais tout ca
a vite dérivé ... Et aujourd'hui avec les outils dont on dispose, on connait
en général immédiatement le type d'un objet. De plus, si on programme à peu
près proprement, on ne se retrouve pas avec 20 pages de codes pour une
fonction, donc le type de l'objet n'est pas décrit très "loin" sur la page.

En .Net il n'est pas du tout recommandé d'utiliser la notation hongroise.

Simon.

"Patrick Philippot" a écrit dans le
message de news:
Esperanza wrote:
Étant débutante en C# et voulant commencer du bon pied, je cherche
une liste de la bonne nomenclature des variables et objets à utiliser
dans mon code. Je n'ai rien trouver de significatif sur le site de
microsoft.



Bonjour,

Ah, je sens que nous allons réveiller une vieille discussion: notation
hongroise ou pas notation hongroise?

La notation hongroise consiste à préfixer le nom d'une variable ou d'un
membre d'une classe avec une ou plusieurs lettres minuscules indiquant son
type. Quelques exemples:

lpszMaChaine (pointeur vers une chaine ASCIIZ)
nValeur (variable de type entier)
cCount (compte d'octets)

Bien que je sois toujours partisan de cette notation, il faut avouer
qu'elle est moins utile dans un environnement (VS .Net) où il est très
facile de visualiser le type d'une donnée (mais tout le monde n'utilise
pas Visual Studio ou un IDE avec des capacités équivalentes). En outre, il
est malpratique (voire inopportun, à cause d'Intellisense) d'utiliser
cette notation pour les membres publics d'une classe. Par ailleurs, cette
notation n'est pas utilisée dans la bibliothèque .Net.

Le consensus semble donc se faire autour d'une nomenclature de type
CamelCase sans préfixe.

Par contre, l'utilisation judicieuse des namespaces fait partie des points
importants. Une hiérarchie cohérente dans laquelle il est facile de
naviguer et de retrouver un élément particulier est probablement
aujourd'hui plus importante qu'une nomenclature très rigoureuse. Le choix
du nom du namespace racine pour vos classes (en général le nom de
l'entreprise ou du département) ainsi que celui des sous-espaces devra
donc être fait avec soin.

--
Patrick Philippot - Microsoft MVP
MainSoft Consulting Services
www.mainsoft.fr



Avatar
Esperanza
Merci pour toutes vos informations,

ma question concernait aussi les noms des objets .net
exemples :
radl pour radioList
col pour collection
Il doit surement exister une liste qq part.

Merci d'avance !!
Chantal



"Simon Mourier [MS]" a écrit dans le message
de news:
Sur la notation hongroise, le préfixe, à l'origine, ne code surtout pas le
type exact mais un "genre" de données. C'est pourquoi on aurait plutôt


écrit
en effet:

int nCount;

et non pas

int iCount;

Et c'était donc relativement portable (8->16->32bits, etc...), mais tout


ca
a vite dérivé ... Et aujourd'hui avec les outils dont on dispose, on


connait
en général immédiatement le type d'un objet. De plus, si on programme à


peu
près proprement, on ne se retrouve pas avec 20 pages de codes pour une
fonction, donc le type de l'objet n'est pas décrit très "loin" sur la


page.

En .Net il n'est pas du tout recommandé d'utiliser la notation hongroise.

Simon.

"Patrick Philippot" a écrit dans le
message de news:
> Esperanza wrote:
>> Étant débutante en C# et voulant commencer du bon pied, je cherche
>> une liste de la bonne nomenclature des variables et objets à utiliser
>> dans mon code. Je n'ai rien trouver de significatif sur le site de
>> microsoft.
>
> Bonjour,
>
> Ah, je sens que nous allons réveiller une vieille discussion: notation
> hongroise ou pas notation hongroise?
>
> La notation hongroise consiste à préfixer le nom d'une variable ou d'un
> membre d'une classe avec une ou plusieurs lettres minuscules indiquant


son
> type. Quelques exemples:
>
> lpszMaChaine (pointeur vers une chaine ASCIIZ)
> nValeur (variable de type entier)
> cCount (compte d'octets)
>
> Bien que je sois toujours partisan de cette notation, il faut avouer
> qu'elle est moins utile dans un environnement (VS .Net) où il est très
> facile de visualiser le type d'une donnée (mais tout le monde n'utilise
> pas Visual Studio ou un IDE avec des capacités équivalentes). En outre,


il
> est malpratique (voire inopportun, à cause d'Intellisense) d'utiliser
> cette notation pour les membres publics d'une classe. Par ailleurs,


cette
> notation n'est pas utilisée dans la bibliothèque .Net.
>
> Le consensus semble donc se faire autour d'une nomenclature de type
> CamelCase sans préfixe.
>
> Par contre, l'utilisation judicieuse des namespaces fait partie des


points
> importants. Une hiérarchie cohérente dans laquelle il est facile de
> naviguer et de retrouver un élément particulier est probablement
> aujourd'hui plus importante qu'une nomenclature très rigoureuse. Le


choix
> du nom du namespace racine pour vos classes (en général le nom de
> l'entreprise ou du département) ainsi que celui des sous-espaces devra
> donc être fait avec soin.
>
> --
> Patrick Philippot - Microsoft MVP
> MainSoft Consulting Services
> www.mainsoft.fr
>




Avatar
Simon Mourier [MS]
Euh et bien non, puisqu'on vient de dire qu'on ne fait pas ce genre de
choses en .Net. Ca n'a pas vraiment de sens.
Simon.

"Esperanza" a écrit dans le message de news:
O5ozmyA%
Merci pour toutes vos informations,

ma question concernait aussi les noms des objets .net
exemples :
radl pour radioList
col pour collection
Il doit surement exister une liste qq part.

Merci d'avance !!
Chantal



"Simon Mourier [MS]" a écrit dans le message
de news:
Sur la notation hongroise, le préfixe, à l'origine, ne code surtout pas
le
type exact mais un "genre" de données. C'est pourquoi on aurait plutôt


écrit
en effet:

int nCount;

et non pas

int iCount;

Et c'était donc relativement portable (8->16->32bits, etc...), mais tout


ca
a vite dérivé ... Et aujourd'hui avec les outils dont on dispose, on


connait
en général immédiatement le type d'un objet. De plus, si on programme à


peu
près proprement, on ne se retrouve pas avec 20 pages de codes pour une
fonction, donc le type de l'objet n'est pas décrit très "loin" sur la


page.

En .Net il n'est pas du tout recommandé d'utiliser la notation hongroise.

Simon.

"Patrick Philippot" a écrit dans le
message de news:
> Esperanza wrote:
>> Étant débutante en C# et voulant commencer du bon pied, je cherche
>> une liste de la bonne nomenclature des variables et objets à utiliser
>> dans mon code. Je n'ai rien trouver de significatif sur le site de
>> microsoft.
>
> Bonjour,
>
> Ah, je sens que nous allons réveiller une vieille discussion: notation
> hongroise ou pas notation hongroise?
>
> La notation hongroise consiste à préfixer le nom d'une variable ou d'un
> membre d'une classe avec une ou plusieurs lettres minuscules indiquant


son
> type. Quelques exemples:
>
> lpszMaChaine (pointeur vers une chaine ASCIIZ)
> nValeur (variable de type entier)
> cCount (compte d'octets)
>
> Bien que je sois toujours partisan de cette notation, il faut avouer
> qu'elle est moins utile dans un environnement (VS .Net) où il est très
> facile de visualiser le type d'une donnée (mais tout le monde n'utilise
> pas Visual Studio ou un IDE avec des capacités équivalentes). En outre,


il
> est malpratique (voire inopportun, à cause d'Intellisense) d'utiliser
> cette notation pour les membres publics d'une classe. Par ailleurs,


cette
> notation n'est pas utilisée dans la bibliothèque .Net.
>
> Le consensus semble donc se faire autour d'une nomenclature de type
> CamelCase sans préfixe.
>
> Par contre, l'utilisation judicieuse des namespaces fait partie des


points
> importants. Une hiérarchie cohérente dans laquelle il est facile de
> naviguer et de retrouver un élément particulier est probablement
> aujourd'hui plus importante qu'une nomenclature très rigoureuse. Le


choix
> du nom du namespace racine pour vos classes (en général le nom de
> l'entreprise ou du département) ainsi que celui des sous-espaces devra
> donc être fait avec soin.
>
> --
> Patrick Philippot - Microsoft MVP
> MainSoft Consulting Services
> www.mainsoft.fr
>