SPPersistedObject-Klasse

Artikel
05/06/2015

Enthält die Methoden für ein Objekt, das automatisch serialisieren Zustand, diesen Zustand in einen permanenten Speicher beibehalten, es zu einem späteren Zeitpunkt abrufen und Deserialisieren in ein Objekt im Arbeitsspeicher.

Vererbungshierarchie

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

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

Syntax

'Declaration
<GuidAttribute("3B60B328-F4D6-4902-BEC6-E904179FA246")> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public Class SPPersistedObject _
    Inherits SPAutoSerializingObject _
    Implements ICloneable
'Usage
Dim instance As SPPersistedObject

[GuidAttribute("3B60B328-F4D6-4902-BEC6-E904179FA246")]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public class SPPersistedObject : SPAutoSerializingObject, 
    ICloneable

Hinweise

Die SPPersistedObject -Klasse stellt eine Basisklasse für alle administrationsobjekte bereit. Serialisiert alle Felder mit dem Persisted XML-Attribut markiert, und schreibt das XML-Blob in der Konfigurationsdatenbank. Die SPPersistedObject -Klasse enthält Code zum Serialisieren all seine Member, die Basistypen, andere beibehaltene Objekte und Auflistungen eines beibehaltene Objekte sind. Konfigurationsdaten, die in beibehaltene Objekte gespeichert ist werden automatisch auf jedem Server in der Farm jeder Prozess zur Verfügung gestellt.

Beim Erstellen eines benutzerdefinierten permanenten Objekts müssen Sie den Standardkonstruktor für Serialisierung angeben.

Um ein vorhandenes beibehaltenen-Objekt zurückzugeben, verwenden Sie die GetObject -Methode der SPFarm -Klasse oder die GetChild -Methode der SPPersistedObject -Klasse.

Beispiele

Das folgende Beispiel veranschaulicht eine benutzerdefinierte Klasse, die von der SPPersistedObject -Klasse erbt, in dem das Attribut Peristed verwendet wird, können Sie Felder für die Serialisierung angeben.

<GuidAttribute("3B60B328-F4D6-4902-BEC6-E904179FA246")>
Public Class MyObject
   Inherits SPPersistedObject
   <Persisted()>  _
   Private location As String

   <Persisted()>  _
   Private url As String

   'The default constructor must be specified for serialization.
   Public Sub New()
   End Sub 'New
   
   Public Sub New(name As String, parent As SPPersistedObject)
      MyBase.New(name, parent)
   End Sub 'New

   Public Overrides ReadOnly Property DisplayName() As String
      Get
         Return Me.url
      End Get
   End Property
   
   Public Property Url() As String
      Get
         Return Me.url
      End Get
      Set
         If Me.url = value Then
            Return
         End If

         Me.url = value
      End Set
   End Property

   Public Property Location() As String
      Get
         Return Me.location
      End Get
      Set
         Me.location = value
      End Set
   End Property
End Class 'MyObject

[GuidAttribute("3B60B328-F4D6-4902-BEC6-E904179FA246")]
public class MyObject : SPPersistedObject
{
   [Persisted]
   private string location;

   [Persisted]
   private string url;

   /*The default constructor must be specified for serialization.*/
   public MyObject()
   {
   }
   public MyObject(string name, SPPersistedObject parent)
      : base(name, parent)
   {
      ;
   }

   public override string DisplayName
   {
      get
      {
         return this.url;
      }
   }

   public string Url
   {
      get { return this.url; }
      set 
      {
         if (this.url == value)
         {
            return;
          }

          this.url = value;
      }
   }

   public string Location
   {
      get { return this.location; }
      set { this.location = value; }
   }
}

Nachdem eine MyObject persistentes Objekt wie im Beispiel erstellt wurde, können Sie mithilfe von SPFarm.Local.GetObject(GUID)zurückgegeben werden.

Threadsicherheit

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

Siehe auch

Referenz

SPPersistedObject-Member

Microsoft.SharePoint.Administration-Namespace

Vererbungshierarchie

SPPersistedObject-Klasse

Vererbungshierarchie

Syntax

Hinweise

Beispiele

Threadsicherheit

Siehe auch

Referenz

Vererbungshierarchie

Zusätzliche Ressourcen