Compartir a través de

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

  • Artículo

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

  • 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