(SPUsageReportType, SPUsagePeriodType, Int32, DateTime) del método SPWeb.GetUsageData

Artículo
05/13/2015

Obtiene una tabla que contiene información sobre el uso de un sitio Web basado en el tipo de informe especificado, el intervalo de tiempo, el número de columnas para mostrar y el último día para mostrar.

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

Sintaxis

'Declaración
Public Function GetUsageData ( _
    itemType As SPUsageReportType, _
    periodType As SPUsagePeriodType, _
    numColsToDisplay As Integer, _
    lastDayToDisplay As DateTime _
) As DataTable
'Uso
Dim instance As SPWeb
Dim itemType As SPUsageReportType
Dim periodType As SPUsagePeriodType
Dim numColsToDisplay As Integer
Dim lastDayToDisplay As DateTime
Dim returnValue As DataTable

returnValue = instance.GetUsageData(itemType, _
    periodType, numColsToDisplay, lastDayToDisplay)

public DataTable GetUsageData(
    SPUsageReportType itemType,
    SPUsagePeriodType periodType,
    int numColsToDisplay,
    DateTime lastDayToDisplay
)

Parámetros

itemType
Tipo: Microsoft.SharePoint.Administration.SPUsageReportType

Un valor de SPUsageReportType que especifica el tipo de informe que se creará.

periodType
Tipo: Microsoft.SharePoint.Administration.SPUsagePeriodType

Un valor de SPUsagePeriodType que especifica el intervalo de tiempo a utilizar en la información que se devuelve.

numColsToDisplay
Tipo: System.Int32

Un entero de 32 bits que especifica el número de columnas que se devuelven en la tabla.

lastDayToDisplay
Tipo: System.DateTime

Un valor de System.DateTime que especifica más reciente día para representar la información que se devuelve. El valor que se pasa en este parámetro debe especificar una hora que es mayor que o igual que el último procesamiento de uso de tiempo se ejecutó para el sitio.

Valor devuelto

Tipo: System.Data.DataTable
Un objeto System.Data.DataTable que contiene la información.

Comentarios

El método GetUsageData devuelve resultados sin definir cuando se pasan parámetros no válidos (por ejemplo, una fecha de hace 100 años). Si el valor pasado en el parámetro numColsToDisplay está fuera del intervalo, se devuelven 31 columnas.

Este método devuelve sólo 2000 registros de los datos de uso para el sitio, mientras que el método GetUsageBlob del protocolo de llamada a procedimiento remoto (RPC) devuelve todos los datos de uso.

Ejemplos

En el ejemplo de código siguiente se rellena un control DataGrid con 12 columnas de información sobre el uso de un sitio, empezando por ayer.

En este ejemplo también se supone la presencia de un control DataGrid .

Using webSite As SPWeb = SPContext.Current.Site.OpenWeb("Site_Name")
    Dim dateValue As System.DateTime = System.DateTime.Today
    dateValue = dateValue.AddDays(- 1)

    DataGrid1.DataSource = webSite.GetUsageData(SPUsageReportType.user, SPUsagePeriodType.day, 12, dateValue)

    DataGrid1.DataBind()
End Using

using (SPWeb oWebsite = SPContext.Current.Site.OpenWeb("Website_URL"))
{
    System.DateTime dtValue = System.DateTime.Today;
    dtValue = dtValue.AddDays(-1);
    DataGrid1.DataSource = 
        oWebsite.GetUsageData(SPUsageReportType.user, SPUsagePeriodType.day, 
        12, dtValue);
    DataGrid1.DataBind();
}

Nota

Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.

Vea también

Referencia

clase SPWeb

Miembros SPWeb

Sobrecarga GetUsageData

Espacio de nombres Microsoft.SharePoint

Share via