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

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.

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.

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. En la barra de menú, elija Archivo, Nuevo, Proyecto.Si el IDE está establecido para utilizar la configuración de desarrollo de Visual Basic, en la barra de menú, elija Archivo, nuevo proyecto.

    Aparecerá el cuadro de diálogo Nuevo proyecto.

  2. Expanda el nodo Visual c# o el nodo Visual Basic, expanda el nodo SharePoint y, a continuación el nodo 2010.

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

  4. En el cuadro Nombre, entre en TestSiteDef, y elija 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 desea depurar la definición de sitio, o utilice 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?, elija el botón de opción 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. seleccione el botón Finalizar .

    El proyecto aparecerá en el Explorador de soluciones.

  8. En Explorador de soluciones, elija el nodo de proyecto y, a continuación, en la barra de menús, elija proyecto, agregar nuevo elemento.

  9. En Visual c# o Visual Basic, expanda el nodo SharePoint y, a continuación el nodo 2010.

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

Crear un elemento web visual

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

Para crear un elemento web visual

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

  2. Elija el nodo del proyecto SiteDefinition1 y, a continuación, en la barra de menú, elija proyecto, agregar nuevo elemento.

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

  3. Expanda el nodo Visual c# o el nodo Visual Basic, expanda el nodo SharePoint y, a continuación el nodo 2010.

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

    El archivo de VisualWebPart1.ascx abra.

  5. En la parte inferior de VisualWebPart1.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>

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

    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, a continuación la línea siguiente bajo la etiqueta de WebPartPages:

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

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

  2. Después del elemento de </asp:Content>, reemplace la sección completa de 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 anteriormente creado.

  3. En Explorador de soluciones, abra el menú contextual para el nodo SiteDefinition1 y, a continuación Conjunto como elemento de inicio.

Implemente y ejecute la solución de definición de sitio

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

Para implementar y ejecutar la definición de sitio

  • En la barra de menú, elija Compilación, Implemente 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 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, elija la ficha Personalizaciones de SharePoint.

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

  6. Deje los otros valores en sus valores predeterminados, y elija el botón Crear.

    Aparecerá el nuevo sitio.

Probar el nuevo sitio

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

Para probar el nuevo sitio

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

    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

Desarrollar soluciones de SharePoint

  • Last updated on