SPWeb.GetUsageData-Methode (SPUsageReportType, SPUsagePeriodType, Int32, DateTime)

Artikel
05/06/2015

Ruft eine Tabelle Informationen zur Verwendung einer Website basierend auf dem angegebenen Berichtstyp Zeitintervall, Anzahl der Spalten zur Anzeige und letzte Tag enthält angezeigt.

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

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

Parameter

itemType
Typ: Microsoft.SharePoint.Administration.SPUsageReportType

Ein SPUsageReportType -Wert, der den Typ des Berichts zu erstellende angibt.

periodType
Typ: Microsoft.SharePoint.Administration.SPUsagePeriodType

Ein SPUsagePeriodType -Wert, der angibt, das Zeitintervall verwendet die Informationen, die zurückgegeben wird.

numColsToDisplay
Typ: System.Int32

Eine 32-Bit-Ganzzahl, die gibt die Anzahl der Spalten in der Tabelle zurückgegeben.

lastDayToDisplay
Typ: System.DateTime

Ein System.DateTime -Wert, der letzten Tag, um die Informationen darstellen, die zurückgegeben wird am meisten angibt. Der Wert, der in diesem Parameter übergeben wird muss angeben eine Zeit, die größer als oder gleich der letzten Zeit die Verarbeitung der Verwendungsanalyse der Website ausgeführt wurde.

Rückgabewert

Typ: System.Data.DataTable
Ein System.Data.DataTable -Objekt, das die Informationen enthält.

Hinweise

Die GetUsageData -Methode gibt undefiniert Ergebnisse zurück, wenn ungültige Parameter übergeben werden (beispielsweise ein Datum von 100 Jahren). Wenn der in der numColsToDisplay -Parameter übergebene Wert außerhalb des Bereichs ist, werden 31 Spalten zurückgegeben.

Diese Methode gibt nur 2000 Datensätze aus der Verwendungsdaten für die Website, während die GetUsageBlob -Methode des Remote Procedure Call (RPC)-Protokoll alle Nutzungsdaten zurückgibt.

Beispiele

Im folgenden Codebeispiel wird füllt eine DataGrid -Steuerelement mit 12 Spalten mit Informationen zur Verwendung einer Website, gestern ab.

In diesem Beispiel wird das Vorhandensein eines Steuerelements DataGrid außerdem vorausgesetzt.

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();
}

Hinweis

Bestimmte Objekte die IDisposable -Schnittstelle implementieren, und Sie müssen vermeiden, diese Objekte im Arbeitsspeicher beibehalten, wenn sie nicht mehr benötigt werden. Informationen zu bewährten Codierung finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPWeb Klasse

SPWeb-Member

GetUsageData-Überladung

Microsoft.SharePoint-Namespace

Share via