SPFarm-Klasse
Stellt eine Microsoft SharePoint Foundation -Farm.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Administration.SPAutoSerializingObject
Microsoft.SharePoint.Administration.SPPersistedObject
Microsoft.SharePoint.Administration.SPPersistedUpgradableObject
Microsoft.SharePoint.Administration.SPFarm
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<GuidAttribute("674DA553-EA77-44a3-B9F8-3F70D786DE6A")> _
<UpgradableAttribute> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public Class SPFarm _
Inherits SPPersistedUpgradableObject _
Implements IBackupRestoreConfiguration, IBackupRestore, IMigratable
'Usage
Dim instance As SPFarm
[GuidAttribute("674DA553-EA77-44a3-B9F8-3F70D786DE6A")]
[UpgradableAttribute]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public class SPFarm : SPPersistedUpgradableObject, IBackupRestoreConfiguration,
IBackupRestore, IMigratable
Hinweise
Das SPFarm -Objekt ist im obersten Knoten im Objektmodell extensible Konfiguration, die Interaktion mit dem Datenspeicher Konfiguration ausgelegt ist. Sie enthält die globale Einstellungen für alle Server, Dienste und Lösungen, die in einer Serverfarm installiert werden. Verwenden Sie die Servers, Servicesoder Solutions -Eigenschaft, um diese Auflistungen abzurufen.
Zugriff auf das aktuelle Objekt des Server-Farm können Sie Mitglieder auf SPFarm.Localverwenden. Um ein SPServiceCollection -Objekt zurückzugeben, die die Auflistung von Diensten in der aktuellen Farm darstellt, verwenden Sie beispielsweise SPFarm.Local.Services. Darüber hinaus können die Farm -Eigenschaft des von der SPPersistedObject -Klasse abgeleitete Klassen oder Sie können die Farm -Eigenschaft der SPSolution -Klasse zum Abrufen der Serverfarm des aktuellen Objekts oder der Lösung.
Beispiele
Im folgende Beispiel wird eine benutzerdefinierte Auftragsdefinition in jeder Webanwendung innerhalb der aktuellen Serverfarm registriert.
Dim farm As SPFarm = SPFarm.Local
Dim service As SPWebService = farm.Services.GetValue < SPWebService > ""
Dim webApp As SPWebApplication
For Each webApp In service.WebApplications
Dim job As SPJobDefinition
For Each job In webApp.JobDefinitions
If job.Name = "MyCustomJobDefinitionName" Then
j.Delete()
End If
Next job
Dim newJob As New MyCustomJobDefinition("MyCustomJobDefinitionName", webApp)
Dim schedule As SPSchedule = SPSchedule.FromString("every 5 minutes between 0 and 59")
newJob.Schedule = schedule
newJob.Update()
Next webApp
SPFarm farm = SPFarm.Local;
SPWebService service = farm.Services.GetValue<SPWebService>("");
foreach (SPWebApplication webApp in service.WebApplications)
{
foreach (SPJobDefinition job in webApp.JobDefinitions)
{
if (job.Name == "MyCustomJobDefinitionName")
{
j.Delete();
}
}
MyCustomJobDefinition newJob = new
MyCustomJobDefinition("MyCustomJobDefinitionName", webApp);
SPSchedule schedule = SPSchedule.FromString("every 5 minutes between 0 and 59");
newJob.Schedule = schedule;
newJob.Update();
}
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.