SPServiceInstance-Klasse

Stellt eine einzelne Instanz eines Diensts, der auf einem Server ausgeführt wird.

Vererbungshierarchie

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.Administration.SPPersistedObject
      Microsoft.SharePoint.Administration.SPPersistedUpgradableObject
        Microsoft.SharePoint.Administration.SPServiceInstance
          

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

Syntax

'Declaration
<GuidAttribute("983C4B09-FBC0-4f4b-92BC-42FABF556ED5")> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
Public Class SPServiceInstance _
    Inherits SPPersistedUpgradableObject
'Usage
Dim instance As SPServiceInstance
[GuidAttribute("983C4B09-FBC0-4f4b-92BC-42FABF556ED5")]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
public class SPServiceInstance : SPPersistedUpgradableObject

Hinweise

Die Klasse SPServiceInstance Services Server zugeordnet. Verwenden Sie die Service -Eigenschaft, um das SPService -Objekt abzurufen, das die farmweite Einstellungen enthält, die für den Dienst gelten, die diese Instanz implementiert wird. Verwenden Sie die Server -Eigenschaft, um das SPServer -Objekt abzurufen, auf dem diese Instanz installiert ist.

Um ein SPServiceInstanceCollection -Objekt zurückzugeben, das die Dienstinstanzen darstellt, die derzeit auf einem Server ausgeführt werden, verwenden Sie entweder die ServiceInstances -Eigenschaft der SPServer -Klasse oder den SPServiceInstanceCollection -Konstruktor. Um ein SPServiceInstanceDependencyCollection -Objekt zurückzugeben, die Dienstinstanzen darstellt, die von einem Dienst abhängig sind, verwenden Sie die Instances -Eigenschaft der SPService -Klasse.

Verwenden Sie eine Indexerstellung, um eine einzelne Dienstinstanz aus der Auflistung zurückzugeben. Beispielsweise, wenn die Auflistung einer Variablen mit dem Namen myServiceInstances, Verwendung myServiceInstances[index] in c# oder myServiceInstances(index) in Visual Basic zugewiesen wird identifiziert, in dem index den Namen oder die GUID ist, die Dienstinstanz. Die Indizierung funktioniert nur mit dem Namen auf, wenn alle Auflistungsobjekte von demselben Basistyp sind. Zusammenstellung Instanz Service häufig enthält jedoch abgeleitete Klassen also nur die GUID sicher zum Abrufen eines Objekts verwendet werden kann. Verwenden Sie die GetValue -Methode der SPPersistedObjectCollection<T> -Klasse, um eine Dienstinstanz anhand des Namens abgerufen.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

SPServiceInstance-Member

Microsoft.SharePoint.Administration-Namespace

Vererbungshierarchie

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.Administration.SPPersistedObject
      Microsoft.SharePoint.Administration.SPPersistedUpgradableObject
        Microsoft.SharePoint.Administration.SPServiceInstance
          Microsoft.SharePoint.Administration.SPDatabaseServiceInstance
          Microsoft.SharePoint.Administration.SPIisWebServiceInstance
          Microsoft.SharePoint.Administration.SPIncomingEmailServiceInstance
          Microsoft.SharePoint.Administration.SPOutboundMailServiceInstance
          Microsoft.SharePoint.Administration.SPRequestManagementServiceInstance
          Microsoft.SharePoint.Administration.SPUsageServiceInstance
          Microsoft.SharePoint.Administration.SPWebServiceInstance
          Microsoft.SharePoint.Administration.SPWindowsServiceInstance