Compartir a través de


del método SPWebApplication.UpdateMappedPage

Actualiza la asignación de la página de aplicación personalizada.

Espacio de nombres:  Microsoft.SharePoint.Administration
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Function UpdateMappedPage ( _
    key As SPWebApplication.SPCustomPage, _
    newValue As String _
) As Boolean
'Uso
Dim instance As SPWebApplication
Dim key As SPWebApplication.SPCustomPage
Dim newValue As String
Dim returnValue As Boolean

returnValue = instance.UpdateMappedPage(key, _
    newValue)
public bool UpdateMappedPage(
    SPWebApplication.SPCustomPage key,
    string newValue
)

Parámetros

  • newValue
    Tipo: System.String

    La ubicación de la página de aplicación personalizada. Esto debe comenzar con "/ _layouts /". Para quitar la asignación de la página personalizada, establezca el valor en una referencia null (Nothing en Visual Basic).

Valor devuelto

Tipo: System.Boolean
true si la página de aplicación personalizada se asigna correctamente; en caso contrario, false.

Comentarios

El parámetro newValue está restringido a una ubicación en la carpeta/_layouts. Al actualizar la página asignada, la dirección URL debe comenzar con "/ _layouts /".

Ejemplos

El ejemplo de código siguiente muestra cómo actualizar la asignación de la página de aplicación de AccessDenied.aspx predeterminada a una página de aplicación personalizada y mostrarlos en la consola. La página de aplicación original se restaura al final.

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;

namespace MapCustomAppPage
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("http://MyServer"))
            {
                //Get a reference to the web application.
                SPWebApplication webApp = site.WebApplication;

                //Update AccessDenied application page to AxsDnd.aspx.
                webApp.UpdateMappedPage(SPWebApplication.SPCustomPage.AccessDenied, "/_layouts/SubFolder/AxsDnd.aspx");
                webApp.Update();

                //Output the newly assigned application page.
                Console.Out.WriteLine(webApp.GetMappedPage(SPWebApplication.SPCustomPage.AccessDenied));

                //Reset the mapping to the default application page.
                webApp.UpdateMappedPage(SPWebApplication.SPCustomPage.AccessDenied, null);
                webApp.Update();

                Console.Out.WriteLine("Press any key...");
                Console.ReadKey();
            }
        }
    }
}
Imports System
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Administration
Module Module1

    Sub Main()

        Using site As New SPSite("http://MyServer")
            'Get a reference to the web application.
            Dim webApp As SPWebApplication = site.WebApplication

            'Update AccessDenied application page to AxsDnd.aspx.
            webApp.UpdateMappedPage(SPWebApplication.SPCustomPage.AccessDenied, "/_layouts/SubFolder/AxsDnd.aspx")
            webApp.Update()

            'Output the newly assigned application page.
            Console.Out.WriteLine(webApp.GetMappedPage(SPWebApplication.SPCustomPage.AccessDenied))

            'Reset the mapping to the default application page.
            webApp.UpdateMappedPage(SPWebApplication.SPCustomPage.AccessDenied, Null)
            webApp.Update()

            Console.Out.WriteLine("Press any key...")
            Console.ReadKey()
        End Using

    End Sub

End Module

Vea también

Referencia

clase SPWebApplication

Miembros SPWebApplication

Espacio de nombres Microsoft.SharePoint.Administration