Класс SPSite
Представляет коллекцию сайтов в веб-приложения, включая веб-сайта верхнего уровня и всех его дочерних сайтов. Каждый объект SPSite или семейства веб-сайтов, представленным в объекте SPSiteCollection , состоящий из коллекции всех семейств сайтов в веб-приложении.
Иерархия наследования
System.Object
Microsoft.SharePoint.SPSite
Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)
Синтаксис
'Декларация
Public Class SPSite _
Implements IDisposable
'Применение
Dim instance As SPSite
public class SPSite : IDisposable
Замечания
Для создания экземпляра объекта SPSite для определенного семейства сайтов на странице ASP.NET или для определенного семейства сайтов в консольном приложении, используйте конструктор SPSite следующим образом:
Dim oSiteCollection As New SPSite("Absolute_URL")
SPSite oSiteCollection = new SPSite("Absolute_URL");
В приложении ASP.NET можно использовать свойство Site класса SPContext для возвращения объекта SPSite , представляющий текущего семейства сайтов:
Dim oSiteCollection As SPSite = SPContext.Current.Site
SPSite oSiteCollection = SPContext.Current.Site;
Используйте свойство Sites класса SPWebApplication для возвращения объекта SPSiteCollection , который представляет коллекцию семейств сайтов в веб-приложения SharePoint. Индексатор используется для возвращения одного семейства сайтов из коллекции. К примеру если переменной с именем oSiteCollectionsназначается коллекцию семейств сайтов, используйте oSiteCollections[index] в C# или oSiteCollections(index) в Visual Basic, где index — это отображаемое имя или номер индекса семейства веб-сайтов в коллекции.
Некоторые объекты реализовать интерфейс IDisposable , и следует избегать хранения этих объектов в памяти, после того, они больше не нужны. При создании собственного SPSite объект, можно использовать метод Dispose , чтобы закрыть объект. Заявление о using можно реализовать также вместо этого, что .NET Framework среде (CLR) автоматически освобождается память, которая используется для хранения семейства сайтов:
Using oSiteCollection = New SPSite("Absolute_URL")
...
End Using
using (SPSite oSiteCollection = new SPSite("Absolute_URL")
{
...
}
Однако если у вас есть ссылка на общий ресурс, например, когда объект предоставляется с помощью метода GetContextSite в веб-части, не используйте либо метод, чтобы закрыть объект. С помощью любого на общий ресурс причины возникновения ошибок нарушение прав доступа. В сценариях, где есть ссылка на общий ресурс вместо позволяют Microsoft SharePoint Foundation или приложение портала управления объекта.
Для получения дополнительных сведений о Рекомендуемый прием написания кода см Disposing Objects.
Важно!
Если установка Infrastructure Update for Windows SharePoint Services 3.0 (KB951695)пользовательские решения невозможно, если они вызова объектной модели SharePoint, пока приостановлена олицетворения. Если используется проверка подлинности Windows и код вызывает объектную модель SharePoint из рабочего процесса Internet Information Services (IIS), запрос необходимо олицетворение удостоверения вызывающего пользователя. SharePoint Foundation настраивает ASP.NET для олицетворения вызывающего пользователя автоматически, но код неожиданно невозможно, если приостановить олицетворения--к примеру, вызвав функцию RevertToSelf Windows API-интерфейса или путем вызова метода System.Security.Principal.WindowsIdentity.Impersonate и передачи IntPtr.Zero в качестве значения параметра маркера пользователя. Даже если код явно не возвращается в исходное, он может быть вызван ASP.NET после возврата его в исходное состояние, такие как происходит при реализации поставщика виртуального пути. Если код не олицетворения вызывающего пользователя, он может работать неправильно.
Потокобезопасность
Любые общедоступные элементы static (Shared в Visual Basic) этого типа являются потокобезопасными. Не гарантируется, что любые элементы экземпляров потокобезопасны.