Tutorial: Creación de un proyecto de definición básica de sitio

  • Artículo

En este tutorial se muestra cómo crear una definición básica de sitio que contiene un elemento web visual con algunos controles agregados. Por motivos de claridad, el elemento web visual que cree tiene solo unos pocos controles. Sin embargo, puede crear definiciones de sitio de SharePoint más sofisticadas que incluyan más funcionalidad.

En este tutorial se muestran las siguientes tareas:

  • Creación de una definición de sitio mediante la plantilla de proyecto de Visual Studio.

  • Creación de un sitio de SharePoint mediante una definición de sitio en SharePoint.

  • Adición de un elemento web visual a la solución.

  • Personalización de la página default.aspx del sitio agregando el nuevo elemento web visual.

    Nota:

    Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Requisitos previos

Necesitará los componentes siguientes para completar este tutorial:

  • Ediciones compatibles de Microsoft Windows y SharePoint. Para más información, consulte los requisitos para desarrollar soluciones de SharePoint.

  • Visual Studio.

Creación de una solución de definición de sitio

En primer lugar, cree el proyecto de definición de sitio en Visual Studio.

Creación de un proyecto de definición de sitio

  1. En la barra de menús, elija Archivo>Nuevo>Proyecto. Si su IDE está establecido para usar la configuración de desarrollo de Visual Basic, en la barra de menús, elija Archivo>Nuevo Proyecto.

    Aparecerá el cuadro de diálogo Nuevo proyecto .

  2. Expanda los nodos Visual C# o Visual Basic y, luego, expanda el nodo SharePoint y elija el nodo 2010.

  3. En la lista Plantillas, seleccione la plantilla Proyecto de SharePoint 2010.

  4. En el cuadro Nombre, escriba TestSiteDef y, luego, seleccione el botón Aceptar.

    Aparece el Asistente para la personalización de SharePoint.

  5. En la página Especifique el sitio y el nivel de seguridad de la depuración, escriba la dirección URL del sitio de SharePoint donde quiere depurar la definición de sitio, o use la ubicación predeterminada (http://nombre del sistema/).

  6. En la sección ¿Cuál es el nivel de confianza de esta solución de SharePoint?, active el botón de opción Implementar como solución de granja.

    Todos los proyectos de definición de sitio deben implementarse como soluciones de granja de servidores. Para obtener más información sobre las soluciones en espacio aislado frente a las soluciones de granja, consulte Consideraciones sobre las soluciones en espacio aislado.

  7. Elija el botón Finalizar.

    El proyecto aparece en el Explorador de soluciones.

  8. En el Explorador de soluciones, elija el nodo del proyecto y, después, en la barra de menús, seleccione Proyecto>Agregar nuevo elemento.

  9. En Visual C# o Visual Basic, expanda el nodo SharePoint y, después, seleccione el nodo 2010.

  10. En el panel Plantillas, elija la plantilla Definición de sitio, deje el nombre como SiteDefinition1 y, luego, elija el botón Agregar.

Creación de un elemento web visual

A continuación, cree un elemento web visual para que aparezca en la página principal de la definición de sitio.

Para crear un elemento web visual, siga estos pasos:

  1. En el Explorador de soluciones, elija el botón Mostrar todos los archivos.

  2. Elija el nodo de proyecto SiteDefinition1 y, luego, en la barra de menús, elija Proyecto>Agregar nuevo elemento.

    Aparecerá el cuadro de diálogo Agregar nuevo elemento.

  3. Expanda los nodos Visual C# o Visual Basic y, luego, expanda el nodo SharePoint y elija el nodo 2010.

  4. En la lista de plantillas, elija Elemento web visual, mantenga el nombre predeterminado, VisualWebPart1 y, luego, elija el botón Agregar.

    Se abre el archivo VisualWebPart1.ascx.

  5. En la parte inferior de VisualWebPart1.ascx, agregue el siguiente marcado para agregar tres controles al formulario: un cuadro de texto, un botón y una etiqueta:

    <table>
  <tr>
    <td>
      <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
    </td>
    <td>
      <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
    </td>
    <td>
      <asp:Label runat="server" ID="lblName"></asp:Label>
    </td>
  </tr>
</table>

  6. En VisualWebPart1.ascx, abra el archivo VisualWebPart1.ascx.cs (para Visual C#) o VisualWebPart1.ascx.vb (para Visual Basic) y agregue el código siguiente:

    protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}

    Este código agrega funcionalidad para el clic del botón del elemento web.

Adición del elemento web visual a la página de ASPX predeterminada

A continuación, agregue el elemento web visual a la página de ASPX predeterminada de la definición de sitio.

Para agregar un elemento web visual a la página de ASPX predeterminada, siga estos pasos:

  1. Abra la página default.aspx y agregue la línea siguiente en la etiqueta WebPartPages:

    <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>

    Esta línea asocia el nombre MyWebPartControls con el elemento web y su código. El parámetro Namespace coincide con el espacio de nombres que se usa en el archivo de código VisualWebPart1.ascx.

  2. Después del elemento </asp:Content>, reemplace toda la sección ContentPlaceHolderId="PlaceHolderMain" y su contenido por el código siguiente:

    <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />
</asp:Content>

    Este código crea una referencia al elemento web visual que creó anteriormente.

  3. En el Explorador de soluciones, abra el menú contextual del nodo SiteDefinition1 y, después, elija Establecer como elemento de inicio.

Implementación y ejecución de la solución de definición de sitio

A continuación, implemente el proyecto en SharePoint y ejecute el proyecto.

Para implementar y ejecutar la definición de sitio

  • En la barra de menús, elija Compilar>Implementar TestSiteDef.

  • Elija la tecla F5.

    Visual Studio compila el código, agrega sus características, empaqueta todos los archivos en un archivo de solución de SharePoint (WSP) e implementa el archivo WSP en SharePoint Server. A continuación, SharePoint instala los archivos y activa las características.

Creación de un sitio basado en la definición de sitio

A continuación, cree un sitio mediante la nueva definición de sitio.

Para crear un sitio mediante la definición de sitio, siga estos pasos:

  1. En el sitio de SharePoint, aparece la página Nuevo sitio de SharePoint.

  2. En la sección Título y descripción, escriba Mi nuevo sitio para el título y una descripción del sitio.

  3. En la sección Dirección del sitio web, escriba mynewsite en el cuadro Nombre de la dirección URL.

  4. En la sección Plantilla, elija la pestaña Personalizaciones de SharePoint.

  5. En la lista Seleccionar una plantilla, elija SiteDefinition1.

  6. Deje la otra configuración en sus valores predeterminados y, luego, elija el botón Crear.

    Aparece el nuevo sitio.

Prueba del nuevo sitio

A continuación, pruebe el nuevo sitio para comprobar que funciona correctamente.

Para probar el nuevo sitio, siga estos pasos:

  • En la página de ASPX predeterminada, escriba texto y, luego, elija el botón Cambiar texto de etiqueta junto al cuadro de texto.

    El texto aparece en la etiqueta del lado derecho del botón.

Contenido relacionado