Метод SPWeb.GetUsageData (SPUsageReportType, SPUsagePeriodType, Int32, DateTime)

Статья
05/13/2015

Возвращает таблицу, содержащую сведения об использовании веб-узла на основе указанный тип отчета, временной интервал, количество столбцов для отображения и последний день для отображения.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Function GetUsageData ( _
    itemType As SPUsageReportType, _
    periodType As SPUsagePeriodType, _
    numColsToDisplay As Integer, _
    lastDayToDisplay As DateTime _
) As DataTable
'Применение
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
)

Параметры

itemType
Тип: Microsoft.SharePoint.Administration.SPUsageReportType

Значение SPUsageReportType , указывающее тип отчета должен быть создан.

periodType
Тип: Microsoft.SharePoint.Administration.SPUsagePeriodType

Значение SPUsagePeriodType , которое задает интервал времени для использования в возвращаемые данные.

numColsToDisplay
Тип: System.Int32

32-разрядное целое число, указывающее количество возвращаемых в таблицу столбцов.

lastDayToDisplay
Тип: System.DateTime

Значение System.DateTime указывает самый последний день для представления информации, возвращается. Значение, которое передается в этом параметре необходимо указать время, больше или равно последняя обработка сведений об использовании времени запуска для веб-узла.

Возвращаемое значение

Тип: System.Data.DataTable
Объект System.Data.DataTable , содержащий информацию.

Замечания

Метод GetUsageData возвращает непредсказуемым результатам, если передаются недопустимые параметры (например, дата 100 лет назад). Если значение, передаваемое в параметре numColsToDisplay находится вне диапазона, 31 столбцы возвращаются.

Этот метод возвращает только 2000 записей из данных об использовании сайта, а метод GetUsageBlob протокола удаленного вызова процедур (RPC) возвращает все данные об использовании.

Примеры

В следующем примере кода заполняет элемент управления DataGrid сведения об использовании веб-узла, начиная с вчера 12 столбцов.

Также в этом примере предполагается наличие элемента управления 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();
}

Примечание

Некоторые объекты реализуют интерфейс IDisposable и следует избегать сохранения этих объектов в памяти, после они больше не нужны. Disposing Objectsсведения о рекомендованные методы программирования, см.

См. также

Справочные материалы

SPWeb класс

Элементы SPWeb

Перегрузка GetUsageData

Пространство имен Microsoft.SharePoint

Поделиться через