Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Convencion de Codificacion en C PDF
Convencion de Codificacion en C PDF
Pascal Case
La primera letra en la identificación y la primera letra de cada palabra concatenada subsiguiente se pone en mayúsculas.
Ejemplo:
BackColor, DataSet
Camel Case
La primera letra en la identificación es minúscula y la primera letra de cada palabra concatenada subsiguiente se pone en mayúsculas.
Ejemplo:
numeroDeDias, esValido
Upper Case
Todas las letras en el identificador deben ser en mayúsculas Use esta convención sólo en los identificadores que consisten en dos o
menos letras.
Ejemplo:
ID, PI
Notación Húngara
La notación húngara es una convención de identificación de las variables en un programa de computación. Esta especificación indica
que cada variable debe ir precedida por un indicador de 1 o más letras que especifican el tipo de variable.
Ejemplo:
string strNombre;
int intCantidad;
double dblPrecioTotal;
2. Convenciones de Nombramiento
Variables Privadas (Fields en C#)
Se debe utilizar Camel Case.
Se debe identificar a la variable con la Notación Húngara.
Se debe identificar con el Prefijo "_".
Ejemplo:
public class Cliente {
string _strNombre; // Por ser privadas de la clase(Fields) tiene "_".
/// <summary>
/// Propiedad Public Nombre
/// </summary>
public string Nombre {
get {return _strNombre;}
set {_strNombre = value;}
}
}
v 2.0.2 1 de 6
Convención de codificación en C# (Alumnos) Ulman 2013
Variables Locales
Se debe utilizar Camel Case.
Se debe identificar a la variable con la Notación Húngara
Ejemplo:
public override string ToString() {
string strReturnValue = "";
strReturnValue += "Este es un String... \n";
return strReturnValue;
}
Namespaces
La regla general para el nombramiento de espacios de Nombres consiste en utilizar la compañía seguida de la Tecnología empleada.
Opcionalmente se puede indicar la característica y diseño.
using CompanyName.TechnologyName[.Feature][.Design];
Ejemplo:
using ORT.Buggy;
using ORT.Buggy.Windows;
using ORT.Buggy.SerialPort;
Clases
Se debe utilizar un sustantivo para nombrar una clase.
Se debe utilizar Pascal Case.
No se debe utilizar ningún tipo de prefijo para denominar la clase como C o T.
No se debe utilizar el caracter (_).
Ejemplo:
public class Cuadrado {}
public class Pantalla {}
public class Cliente {}
public class ClienteVIP {}
public class Factura {}
Parámetros
Se deben utilizar nombres descriptivos para los nombres de los parámetros.
Se debe utilizar Camel Case.
Se debe identificar a los parámetros con la Notación Húngara
Ejemplo:
public bool Existe(int intCodigo, bool blnExtended) {}
public Cliente GetByCodigo(int intCodigo, bool blnExtended) {}
Métodos
Se deben utilizar verbos o frases con verbos para identificar a los métodos.
Se debe utilizar Pascal Case.
Ejemplo:
public void RemoveAll();
public bool Insertar();
public char GetCharAt();
public Factura GetUltimaFactura();
Enumeraciones
Se debe utilizar Pascal Case.
No se debe utilizar la notación Húngara.
Se debe utilizar el sufijo “Enum” en las enumeraciones.
Evite cambiar el tipo de dato de la enumeración. Por default es int
Ejemplo:
public enum ClientesEnum {
Codigo,
Nombre,
Orden ,
Activo
};
v 2.0.2 2 de 6
Convención de codificación en C# (Alumnos) Ulman 2013
Propiedades
Se debe utilizar Pascal Case.
No se debe utilizar la notación Húngara.
Ejemplo:
public class Cliente {
int _intCodigo; // Por ser privadas de la clase(Fields) tiene "_".
string _strRazonSocial; // Por ser privadas de la clase(Fields) tiene "_".
Excepciones
Los Manejdores de Eventos en .NET tienden a utilizar “e” como parametro en la invocacion al evento. Para asegurarnos de que no
exista conflicto alguno con este parametro, utilizaremos “ex” como la variable estandar del tipo Exception.
Ejemplo:
private void Page_Load(object sender, System.EventArgs e){
...
try{
...
}catch(Exception ex){
MessageBox.Show(ex.Message)
}
}
v 2.0.2 3 de 6
Convención de codificación en C# (Alumnos) Ulman 2013
Ejemplo:
if (unaExpresion){
HacerAlgo ();
}else{
HacerOtraCosa ();
}
Ejemplo:
switch (unaExpresion) {
case 0:{
HacerAlgo();
break;
}
case 1:{
HacerOtraCosa();
break;
}
case 2:{
int n = 1;
HacerAlgoMas(n);
break;
}
}
Las llaves nunca deben considerarse opcionales, se deben utilizar aunque exista una sola instrucción. De esta nabera se
incrementa la legibilidad del código y su mantenimiento.
Ejemplo:
for (int i=0; i < 100; i++) {
HacerAlgo (i);
}
Se debe considerar como obligatorio la utilización de llaves en todas las estructuras de control (if, while, for, etc.), aunque
contengan una sola sentencia.
v 2.0.2 4 de 6
Convención de codificación en C# (Alumnos) Ulman 2013
Ejemplo:
//-------------------------------------------------------------------
// <copyright file="Buggy.cs" company="ORT Agentina">
// Copyright (c) ORT Agentina. All rights reserved.
// </copyright>
//-------------------------------------------------------------------
Comentarios en la Documentación
Todos los métodos deben utilizar el formato XML para la documentación. Existen herramientas tanto en Visual Studio, como de
terceras partes para generar la documentación automática a partir de Tags XML.
Para generar el encabezado standard de la documentación simplemente debemos posicionarnos en la línea previa al comienzo del
método, y presionar 3 veces el caracter “/”. (///)
Ejemplo:
/// <summary>
/// Incrementar los Vuelos del Usuario, y actualizar su nombre.
/// </summary>
/// <param name="intUsuario">Codigo de Usuario</param>
/// <param name="strNombre">Nuevo nombre del Usuario.</param>
/// <returns>Retorna true en caso de que la cantidad ...</returns>
public bool Incrementar(int intUsuario, string strNombre) {
bool blnReturnValue = false;
// Cuerpo del Metodo
// ...
return blnReturnValue;
}
Estilos de Comentado
La utilización del comentado utilizando las 2 barras //, deben utilizarse en varias situaciones. Siempre que sea posible, inserte los
comentarios sobre el Codigo y no por debajo.
Ejemplo:
// Se requiere para la utilización a traves del Proxy.
GlobalProxySelection.Select = new WebProxy("http://www.polshu.com.ar");
v 2.0.2 5 de 6
Convención de codificación en C# (Alumnos) Ulman 2013
Espaciado
Los espacios incrementan la legibilidad, y decrementan la densidad del código. A continuación se describen algunas reglas a cumplir
Ejemplo:
Utilice un espacio luego de una coma, entre los argumentos de una invocación a un método.
Correcto: Console.In.Read(myChar, 0, 1);
Incorrecto: Console.In.Read(myChar,0,1);
v 2.0.2 6 de 6