Guía de colaboradores

De C# Online.NET (CSharp-Online.NET)—su enciclopedia libre de C# y .NET

Su colaboración es bienvenida! De hecho, este proyecto depende de usted y de otros que escriben y editan artículos y tutoriales, y que contribuyen con código fuente C# para el bienestar de la comunidad de programadores C#.

Recomendaciones Básicas

Primero, usted debe crear un id de usuario y un login para poder editar. Este es un proceso rápido y sencillo de un sólo paso. Luego, edite su página de usuario para que nos diga un poco sobre usted y su experiencia, y donde vive.
Luego lea nuestra Misión.
A continuación se entregan unas recomendaciones simples para colaboradores:

Siga el estilo existente.

Delimite fragmentos de código C# con los tags <pre></pre> o <CSO_Source></CSO_Source> . Los tags <CSO_Source> hacen resalto de sintáxis similar a Visual Estudio y permiten numeración automástica de líneas.

Delimite código y palabras C# con los tags <code></code>.

Use markup MediaWiki cuando sea posible, por ejemplo para Sections y Lists.

Por favor NO USE el signo hash (#) en enlaces MediaWiki! El nombre de enlace será truncado debido a que el signo # es tratado como un caracter de fin de línea. Debido a eso, use la palabra "CSharp" donde usaría "C#" en un nombre de enlace.

Las personas se apasionan con su estilo de código y convenciones; pero use el siguiente estilo de indentado para todo sus fragmentos de código:
class ClassName { 
   // código C#
   } // indentado de 3 espacios 
Los enlaces externos deben ser hacia la página Home, o hacia una página que es sección principal y NO a un artículo individual y NUNCA hacia el interior de una página (usando el signo #).

Resaltando Sintáxis

Los tags <CSO_Source> llevan a cabo resalto de sintáxis similar a como lo hace Visual Studio y perminen numeración automática de líneas.

Use <CSO_Source>...</CSO_Source> para producir resalto de sintáxis para C#:

ColorDialog colorDialog = new ColorDialog(); 
if ( colorDialog.ShowDialog() != DialogResult.Cancel ) { 
   textBox.ForeColor = colorDialog.Color;
   }

No use numeración de líneas a menos que usted quiera referirse a ellas dentro de su texto. Para producir números de línea, debe incluir una opción en corchetes ([[]]). El primer elemento en la lista de opciones es el lenguaje , ej: csharp. La segunda opción es el número de línea inicial .

<CSO_Source>[[csharp,1]]...</CSO_Source> producirá la siguiente salida enumerada:

ColorDialog colorDialog = new ColorDialog(); 
if ( colorDialog.ShowDialog() != DialogResult.Cancel ) { 
   textBox.ForeColor = colorDialog.Color;
   }

<CSO_Source>[[csharp,10]]...</CSO_Source> producirá la siguiente salida enumerada comenzando en la línea 10:

ColorDialog colorDialog = new ColorDialog(); 
if ( colorDialog.ShowDialog() != DialogResult.Cancel ) { 
   textBox.ForeColor = colorDialog.Color;
   }

Se pueden sobresaltar líneas de código —número de línea en negrita, contenido en amarillo—especificando los números de línea entre paréntesis individualmente y/o en rangos de pares. Por ejemplo, <CSO_Source>[[csharp,10,(11-13)]]...</CSO_Source> producirá la siguiente salida enumerada:

ColorDialog colorDialog = new ColorDialog(); 
if ( colorDialog.ShowDialog() != DialogResult.Cancel ) { 
   textBox.ForeColor = colorDialog.Color;
   }

Alternativamente, <CSO_Source>[[csharp,10,(11,13)]]...</CSO_Source> producirá la siguiente salida enumerada:

ColorDialog colorDialog = new ColorDialog(); 
if ( colorDialog.ShowDialog() != DialogResult.Cancel ) { 
   textBox.ForeColor = colorDialog.Color;
   }

Use <CSO_Source>[[langlist]]</CSO_Source> para producir una lista de lenguajes soportados, como la siguiente:

Current enabled languages: actionscript, ada, apache, asm, bash, c, cpp, csharp, css, delphi, dos, eiffel, html, ini, java, java5, javascript, js, lisp, matlab, mpasm, objc, oracle8, pascal, perl, php, pseudocode, python, qbasic, ruby, scheme, smarty, sql, vb, vbnet, vhdl, xhtml, xml.

Anomalías

Los nombres de clases del sistema deben ser adicionados por el Administrador Wiki a una lista maestra para que la sintáxis sea coloreada correctamente. Un ejemplo es ColorDialog arriba. Si sus nombres de clases del sistema no están en esa lista, usted puede solicitar que sean adicionadas.

Algunas veces, el resaltado amarillo de líneas numeradas parece que no aparece correctamente en Internet Explorer.

C# versus CSharp

Usted notará que nosotros usamos el término "CSharp" en vez de "C#". Desafortunadamente, algunos programas no soportan el signo de almoadilla (#) en algunos contextos. Por ejemplo, esta aplicación Wiki no soporta el signo de almoadilla en sus enlaces internos. Por lo tanto, usamos la frase "CSharp" cuando es necesario. Los dos términos son sinónimos. Y la pronunciación apropiada del lenguaje de programación "C#" es "C-sharp"