SPWeb.GetUsageData - Méthode (SPUsageReportType, SPUsagePeriodType, Int32, DateTime)

Article
05/12/2015

Obtient un tableau qui contient des informations sur l'utilisation d'un site Web basé sur le type de rapport spécifié, intervalle de temps, nombre de colonnes à afficher et le dernier jour à afficher.

Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Function GetUsageData ( _
    itemType As SPUsageReportType, _
    periodType As SPUsagePeriodType, _
    numColsToDisplay As Integer, _
    lastDayToDisplay As DateTime _
) As DataTable
'Utilisation
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
)

Paramètres

itemType
Type : Microsoft.SharePoint.Administration.SPUsageReportType

Une valeur SPUsageReportType qui spécifie le type de rapport à créer.

periodType
Type : Microsoft.SharePoint.Administration.SPUsagePeriodType

Une valeur SPUsagePeriodType qui spécifie l'intervalle de temps à utiliser les informations retournées.

numColsToDisplay
Type : System.Int32

Entier 32 bits qui spécifie le nombre de colonnes à renvoyer dans le tableau.

lastDayToDisplay
Type : System.DateTime

Une valeur System.DateTime qui spécifie le plus récent jour pour représenter les informations retournées. La valeur qui est passée dans ce paramètre doit spécifier une heure qui est supérieure à ou égal à du dernier traitement de l'utilisation de temps a été exécutée pour le site.

Valeur renvoyée

Type : System.Data.DataTable
Un objet System.Data.DataTable qui contient les informations.

Remarques

La méthode GetUsageData renvoie des résultats indéfinis lorsque des paramètres non valides sont passés (par exemple, une date à partir de 100 ans). Si la valeur passée dans le paramètre numColsToDisplay est hors limites, 31 colonnes sont renvoyées.

Cette méthode retourne des 2000 uniquement enregistrements à partir des données d'utilisation du site, tandis que la méthode GetUsageBlob du protocole d'appel de procédure distante (RPC) renvoie toutes les données d'utilisation.

Exemples

L'exemple de code suivant remplit un contrôle DataGrid avec 12 colonnes des informations sur l'utilisation d'un site, à partir de la veille.

Cet exemple suppose également la présence d'un contrôle 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();
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Voir aussi

Référence

SPWeb classe

SPWeb - Membres

GetUsageData - Surcharge

Microsoft.SharePoint - Espace de noms

Partager via