Compartir a través de

Tutorial: Crear un proyecto de definición de sitio básico

  • Artículo

En este tutorial se muestra cómo crear una definición de sitio básica que contenga un elemento web visual con algunos controles. Por razones de claridad, el elemento web visual que va a crear tiene pocos controles. Sin embargo, puede crear definiciones de sitio de SharePoint más sofisticadas con más funcionalidad. Para obtener más información, vea Tutorial: Crear una definición de sitio con contenido adicional.

En este tutorial se muestran las siguientes tareas:

  • Crear una definición de sitio utilizando la plantilla de proyecto de Visual Studio.

  • Crear un sitio de SharePoint utilizando una definición de sitio en SharePoint.

  • Agregar un elemento web visual a la solución.

  • Personalizar la página default.aspx del sitio agregándole el nuevo elemento web visual.

Nota

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. 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 Valores de configuración de Visual Studio.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

  • Ediciones compatibles de Microsoft Windows y SharePoint. Para obtener más información, vea Requisitos para desarrollar soluciones de SharePoint.

  • Visual Studio 2010.

Crear una solución de definición de sitio

Primero, cree el proyecto de definición de sitio en Visual Studio.

Para crear un proyecto de definición de sitio

  1. Muestre el cuadro de diálogo Nuevo proyecto apuntando a Nuevo en el menú Archivo y haciendo clic en Proyecto.

  2. Expanda el nodo SharePoint bajo Visual C# o bajo Visual Basic, a continuación, SharePoint y después haga clic en 2010.

  3. En el recuadro Plantillas, seleccione Definición de sitio.

  4. En el cuadro Nombre, escriba TestSiteDef y, a continuación, haga clic en 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 para el sitio de servidor de SharePoint donde desea depurar la definición de sitio, o utilice la ubicación predeterminado (http://nombre sistema/).

  6. En la sección ¿Cuál es el nivel de confianza de esta solución de SharePoint?, use el valor predeterminado de Implementar como solución de granja de servidores.

    Todos los proyectos de definición de sitio se deben implementar como soluciones de granja. Para obtener más información sobre soluciones de granja y soluciones en espacio aislado, vea Consideraciones sobre las soluciones en espacio aislado.

  7. Haga clic en Finalizar. El proyecto aparecerá en el Explorador de soluciones.

Crear un elemento web visual

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

Para crear un elemento web visual

  1. Haga clic en Agregar nuevo elemento en el menú Proyecto para mostrar el cuadro de diálogo Agregar nuevo elemento.

  2. Haga clic en el botón Mostrar todos los archivos en el Explorador de soluciones para que aparezcan todos los archivos.

  3. En la vista de árbol Plantillas instaladas, seleccione el nodo Visual C# o el Visual Basic, a continuación SharePoint, a continuación 2010 y por último haga clic en Elemento web visual en la lista de plantillas de elemento de proyecto. Utilice el nombre predeterminado VisualWebPart1.

    Esto abre el archivo VisualWebPart1UserControl.ascx.

  4. En la parte inferior de VisualWebPart1UserControl.ascx, agregue el marcado siguiente 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>

  5. Abra el archivo VisualWebPart1UserControl.ascx.cs (para Visual C#) o VisualWebPart1UserControl.ascx.vb (para Visual Basic) que se encuentra en VisualWebPart1UserControl.ascx y agregue el siguiente código:

    Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
    lblName.Text = tbName.Text
End Sub

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

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

Agregar el elemento web visual a la página ASPX predeterminada

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

Para agregar el elemento web visual a la página ASPX predeterminada

  1. Abra la página default.aspx y agregue lo siguiente bajo la etiqueta WebPartPages:

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

    Esta línea asocia el nombre MyWebPartControls al elemento web y su código. El parámetro Namespace es igual que el espacio de nombres utilizado en el archivo de código VisualWebPart1Usercontrol.ascx.

  2. Después del elemento </asp:Content>, reemplace la sección ContentPlaceHolderId="PlaceHolderMain" completa y su contenido por lo 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 anteriormente creado.

Ejecutar e implementar la solución de definición de sitio

A continuación, ejecute el proyecto e impleméntelo en SharePoint.

Para ejecutar e implementar la definición de sitio

  • Presione F5. Visual Studio compila el código, agrega sus características, empaqueta todos los archivos en un archivo WSP e implementa el archivo WSP en el servidor de SharePoint. A continuación, SharePoint instala los archivos y después activa las características.

Crear un sitio basado en la definición de sitio

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

Para crear un sitio utilizando la definición de sitio

  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 Nuevo sitio como título y una descripción del sitio.

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

  4. En la sección Plantilla, haga clic en la pestaña Personalizaciones de SharePoint, seleccione TestSiteDef en la lista Seleccionar una plantilla.

  5. Deje los otros valores en su valor predeterminado y haga clic en Crear.

    Aparecerá el nuevo sitio.

Probar el nuevo sitio

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

Para probar el nuevo sitio

  • En el cuadro de texto de la página ASPX predeterminada, escriba un texto y haga clic en el botón cuadrado situado junto al cuadro de texto.

    El texto aparece en la etiqueta a la derecha del botón.

Vea también

Tareas

Cómo: Crear un receptor de eventos

Otros recursos

Tutorial: Crear una definición de sitio con contenido adicional

Desarrollar soluciones de SharePoint